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With Bravado; your decision to get into 
multimedia is really quite simple. 




If you’re thinking about developing multimedia applications, Truevision Bravado 
Multimedia Engines make a green light even greener. 


Why are the developers crossing the street? 


■ Controllable video-in-a-window 

■ Stereo or monaural audio 


■ Microsoft® Windows'" 3.x drivers, with 
Multimedia Extensions 

■ MS-DOS® drivers 


■ 8- or 16-bit VGA on-board 

■ Comprehensive Developer Toolkit 

■ Powerful expansion capabilities 

■ Outstanding technical support 
Multimedia is where developers and integrators are headed, and the pace is 

quickening. Truevision Bravado gets you up to speed with extensive functions and full 
support. Traffic is starting to get heavy, so get going with Bravado. 

For more information on the Truevisionary Developer Program, 

CALL 1 -800-344-TRUE and ask for Operator 5. 
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C CODE FOR THE PC 

source code, of course 

DBAPrep (embedded SQL to C translator; supports Oracle, Sybase, SQL Server, XDB, Novell XQL, SQLBase, and QE-Lib).$1,500 

Embedded DOS (full-features, real-time, multitasking, 331-compatible DOS for embedded system and self-bootable installations).$375 

Style (a C+ + class library to build, maintain and traverse arbitrary, non-taxonomic links between C+4- objects).$300 

Spe ll Time (spelling checker for incorporation into test products; no royalty, large dictionary; small and fast).$300 

ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 

INGRAF (graphics for scientists & engineers, all sorts of graphs & plots; specify Microsoft or Borland).$275 

The Snooper (Ethernet protocol analyzer for Novell NetWare and LAN Manager Networks; capture packets; real-time display).$275 

Report Ease (report writer and mail merge engine, include forms and produce reports from your product; no royalties).$275 

EirboTteX (Release 3.0; HP, PS, dot drivers; CM fonts; Lal£X; MetaFbnt)..$250 

Rogue Wfcve tools.h+-f- or math.h++ Class Libraty (extensive docs).each $240 

InOontrol Tbolbax(forms package for Windows; validation functions, date/time, regular expression formatted text control).$210 

PxSQL (SQL for Borland's Paradox Engine; ANSI X3.135-1969 SQL-DML standard; network server not required).$180 

c-pslib (PostScript generation library for C programs; includes complete graphics, font, rotation & paragraph support).$170 

cfc+ 4- Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, disk pager, database functions, much more).$170 

Viewpoint (C-H 4-graphics library, 32-bit color, pattern fill, scroll & bitmap, coordinate tranformations).$170 

Minix Operating System (Version 13; Unix-like operating system, indudes manual; specify 5.25” or 3.5” diskettes).$150 

ViewTHeve (relational view of Novell Btrieve databases; indudes EZTHeve).$150 

DdorieGCC for MS-DOS (Version 1.05; includes C4-4-, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

Booter Tbolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) .$120 

Dr. MD (runtime memory analyzer & debugger; find many memory corruption errors; examine memory usage).$110 

SCM (portable Scheme in C, conforms to IEEE and 3.99 specs, garbage collection, mixs with C; SCM3C12/SLIB1B3).$100 

PCyiP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

Demacs (complete GNU Emacs for DOS; needs djgcc to build; based on 18.55).$100 

BASH (key-indexed record management system for DOS and Windows DDL; record locking for concurrent access environments).$95 

Ibrow (programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$90 

Saipt Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features).$90 

HorC4-4- (C4- 4- Class Library for Borland’s Paradox Engine).$80 

VMEM (virtual memory manager by Blake McBride, Version 3.6, LRU pager, dynamic swap file, image save/reslore).$80 

CPPCOMM (Version 2.0; C4- 4- class library for serial communications).$75 

IteeDraw (PostScript display of labeled hierarchical trees; DOS & Windows screen display induded; Moen algorithm).$75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C++).$65 

ps3d (3-dimensional perspective line drawings with PostScript output).$60 

LDB (Loose Data Binder; persistent data objects for C4- 4-; handles pointers between objects) .$60 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

MEM.WING (global memory manager for Windows, supports standard C memory allocation calls to "wing” your old C code into Windows) . $55 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

CALC (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

Floppy TAR (TAR backup and restore on MS-DOS devices; direct access to non-standard devices) .$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

OBJASM (convert .obi files to .asm files; output is MASM compatible).$50 

CLIPS Version 5.1 (rule-based expert system generator, advanced manuals available at additional cost).$50 

NIH Class Library & Book (basic C++ classes & Data Abstraction and Object-Oriented Proffamtiingm C4-4- in softback by Keith Gorien) $50 

Editor Pack (19 public domain editors; including microEmacs 3.11, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, & GRIEF) .$50 

MicroC C Compiler (retargetable C compiler with optimizer, libraries, and utilities; lots of docs, very portable, tables for 5 cpu’s).$50 

TOUR (beautiful traveling salesman problem solver, finds minimum length paths quickly, includes graphics & plotting programs) .$40 

Charting Routines (Version 1.0; produce many kinds of charts from ASCII data files; rasterized high quality printing mature).$40 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; domestic distribution only) .... $40 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Database Pack(9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

Bison & BYACCfYACC workalike parser generators; documentation; includes C and C4- 4- grammars).$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

REGX Plus (Version 2.0, search and replace string manipulation routines based on regular expressions).$30 

GNU Awk & Diff for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

UUPC Pack (UUCP for the PQ UUPC Version 1.11Q by Wonderworks and smail/PC Version 25 by Stephen G Trier).$25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

Tbl Version 6.1 (Ibol Command Language; add shell programming capability to any command line; elegant command line language) .... $25 

FLEX (fast lexical analyzer generator; new, improved I-EX; BSD version 23.6 with docs).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; Keeps track of software development).$20 

PCAL Personal Calendar (generates PostScript calendar for any month or year, lots of options, personalization file for your dates & schedule) $20 

Publisher’s Interchange Language (PIL Tbol Kit, Version 5.0, API 20 by Quark).$20 

NetCDF (Network Common Data Form; general-purpose data exchange for scientific data; many tools and programs available).$20 

Data 

Moby Thesaurus (25K root words, 1.2M synonyms).$350 

Moby Part-of-Speech (200,000 words and phrases described by prioritized part(s)-of-speech).$120 

Moby Words (500,000 words & phrases, 9,000 stars, 15,000 names).$80 

Moby Shakespeare (plays, sonnets, etc.... every last word).$60 

Dictionary Ward List (234,932 words in alphabetical order).$60 

Roger's 1911 Thesaurus.$40 

U. S. Cities (names & longitude/latitude of 32000 U.S. cities and 6,000 state boundary points).$35 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; Africa, Asia, Europe, N. & S. America) $35 

The World Digitized (100,000 longitude/latitude of world country boundaries).$30 

Lots ’O Words (160,086 German, 178,430 Dutch, 61,843 Norwegian, 60,453 Italian, 138,257 French, 53,142 English) .$30 

"fort Pack (1990 CIA World Fact Book, Hacker’s Jargon File, Acronyma, Koran, Mormon Scriptures, One Liners, Mnemonics, more) .... $25 

CD-ROMs 

Font Master Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB).$70 

InfoMagic (X11R5, Tahoe 4.3 BSD, complete GNU, ISODE, KA9Q & NCSA TCP/IP, all TCP/IP docs, DOS tools; 600MB).$70 

Prime nmc Freeware (over 1 gigabyte of Unix C code).$60 

American Business Phone Book (telephone numbers of 9.2 million businesses by type, geography, and name).$50 

Wiinut Creek XUR5 and GNU (X11R5 with contributed and compaourcesx, 120 GNU programs, SPARC executables).$35 

Vifalnut Creek Usenet and Simtel Unix-C (600MB).$35 

Wiinut Creek Simtel 20 MSDOS Archive (C source oode but lots of other stuff too).$20 

The Austin Code Works Voice: (512) 258-0785 

11100 Leafwood Lane ■ much more ... ask for catalog FAX: (512) 258-1842 

Austin, Texas 78750-3587 USA E-mail: info@acw.com 
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• Software Libraries 

• Background 
Downloading 

• Powerful Search 
Feature 

• Hypertext to file 
downloads, mail 
addressing, and user 
information 


Not only does BIX have great Windows information, now it 
has a great Windows interface. 

On BIX, you will find the Windows Information Exchange, a 
place to get answers about all aspects of windows. Whether 
you are just getting started or you are into programming, 
BIX is the place to be. You will find thousands of Windows 
enthusiasts and thousands of files in the file libraries. 

Lots of New Files 

BIX publishes hundreds of new files each month. You can 
find files by date or keyword, and you can even download 
them in the background with a simple click. 



kye.zip 
lander.zip 
Iaunc201.zip 
lava.zip 
lensl 01 .exe 
leonard.zip 
liberty.lzh 
Iife32.zip 
Iiw100.zip 
longtask.zip 
looksbad.zip 
lywhit.zip 
lzsslib.zip 
macbla12.zip 
magcat11.zip 
magicl 12.zip 
makefont.zip 
map.zip 


25306 

25600 

20736 

49664 

8576 

279805 

116480 

57248 

81920 

18432 

30720 

31744 

18944 

20354 

155830 

46976 

12288 

11264 


kye is a new windows game from england which i found o 
lunar lander for windows 3.0. will not work on windows 
simple, fast keyboard-oriented app launcher for win 3. 
windows version of the famous lava lamp - beautiful! 
lens 1.01 by ned konz - a windows magnifier 
leonard - an actor based object drawing program for wi 
color bitmap of the statue of liberty 
watcom 32-bit life simulation for windows, demonstrates 
a file viewer for windows 3.0 let's you view file In he 
illustration of carrying out a long task with a “% comp 
sound - ghostbusters - "ray, this looks extrodinarily b 
contains drives-hard disk free space as icon, tasks-ico 
edi Izss compression dll for windows 3.00 - version 1.0 
game: blast the evil mac-invaders with rotten apples as 
magcat 1.1 - the magazine cataloger 
screen saver for windows 3.0 

makefont allows you to generate new fonts for windows 
this article discusses mapping modes In the microsoft w 



BIX is Affordable 

Subscribe to BIX for only $13 per month. Connect to BIX 
locally via Tymnet for only $3 per hour.* Or, choose the 
20/20 Plan, where $20 per month covers your first 20 hours 
of evening and weekend access. 

Additional time is only $1.80 per hour on the 20/20 Plan.* 
Once online, you can download BIXnav at the introductory 
price of only $9.95. 


For additional information call 
1-800-695-4775 or 617-354-4137. 

BIX is a service of 
General Videotex Corporation, 

1030 Massachusetts Avenue, 4th Floor, 
Cambridge, MA 02138. 
617-491-3342. 


Join BIX Now! 

Using any communications program, dial 1-800-695-4882. 
Enter “bix” at the prompt. When you are prompted for 
“Name?” enter “bix.windows” and complete the online 
registration. Pay by credit card for immediate access. 


*Rates listed apply for evening and weekend 
access from within the contiguous 48 states. 
Daytime access from within the contiguous 48 
states is billed at $9 per hour. 
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From the Editor 


We're not in the magazine business here; we’re in the information business. That 
may sound like splitting hairs, but the distinction is important. If you develop 
software, then you're in the information business too. What makes one program 
better than another is usually the amount of information embedded in it. Besides 
formatting text, my word processor knows how to check my spelling and suggest 
synonyms for words. Besides creating object files, my compiler knows how to point 
out constructs that, while not syntactically incorrect, might not be what I intended. 
Besides storing and retrieving records, my database knows how to dial the phone 
for me when I call up the record containing an author's personal data. These are all 
examples of embedded information, or “smarts," that make products more valuable. 

All this leads up to the fact that I am happy to introduce the Windows/DOS 
Developer's Journal online index, pictured below. We will be distributing the index as 
widely as possible via a variety of electronic channels. The index is a way to in¬ 
crease the information content of our product. Those back issues are more useful 
when it’s easy to quickly locate the exact article you were looking for. The index is a 
Windows help File with a high degree of cross-referencing - I find it a pleasure to 
use and hope you will too. Since the index is created on-the-fly from a “live” 
database, it will be easy to make corrections or add enhancements based on reader 
feedback. Constructing the index reminded me how many great technical articles 
we’ve run, and of the depth and breadth of experience of our audience. Many 
thanks to all the subscribers who became authors and helped create all those great 
back issues. I look forward to indexing all your future contributions as well. 



ont rteviewer. by Doug uvermyet 
A Windows assert!) with Symbolic Stack Trace, by Matt Pietrefr 
April 1992 Tech Tips, by Leor Zolman 
April 1992 Windows Questions and Answers, by Paul BonneaiT 
August 1992 Windows Questions and Answers, by Paul Bonn*? 
Building Free-Standing Control Buttons, by Alex Leavens * 




Ron Burk 

Editor 

CIS: 70302,2566-, BIX: rlburk-, Internet: ronb@rdpub.com ("... !uunet!rdpub!ronb") 
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The Digital Video Interface for Windows Multimedia 

Victor R. Volkman 


Introduction 

Although the basic hardware for multimedia has been 
available since the late 1980s, multimedia applications have 
been slow to appear. The initial barriers were the high cost of 
multimedia hardware and the raw CPU power required to 
drive it. The final barrier was the lack of a device-independent 
platform on which to build the applications. Microsoft has 
made a clear commitment to overcoming this hurdle with the 
Media Control Interface (MCI), which first appeared in August 
1991 as part of Multimedia Extensions 1.0 for Windows. Today, 
it plays an increasingly important role in the Windows 3.1 en¬ 
vironment. 

The MCI layer lets applications control both audio and 
visual peripherals in a device-independent fashion. MCI was 
originally designed to work with CD-ROMs, Digital Audio Tapes 
(DAT), video overlay adapters, image scanners, MIDI sequen¬ 
cers, VCRs, LaserDisc players, and audio digitizers. In March 
1992, Microsoft and Intel jointly announced the Digital Video 
specification for MCI. Developing digital video applications re¬ 
quires additional hardware, such as the Intel ActionMedia II 


What You’ll Need for Digital Video 
Software 

Windows 3.1 or Windows 3.0 and Multimedia Extentions 
Windows 3.1 SDK or Windows 3.0 SDK and Multimedia 
Development Kit 1.0 
Digital Video Class for MCI 

Hardware 

Multimedia-capable PC (including CD-ROM) 

Digital video hardware (e.g. Intel ActionMedia II, 
sug. retail $2596) 

Video source(s) (camcorder, VCR, LDV, etc.) 


adapter, to record and playback video programs. Although the 
specification is still undergoing beta review as of this writing, 
it is expected to be in final form by the end of June 1992 (see 
sidebar). The accompanying digitalvideo device class encap¬ 
sulates the recording, playback, and management of external 
video sources. Before delving into the capabilities and limita¬ 
tions of the digitalvideo class, I'll briefly review some basic 
MCI concepts. 

MCI Software Layer 

The MCI software layer (see Figure 1) insulates your multi- 
media application from having to know the complex details of 
each actual device interface. This isolating layer consists of 
device drivers which respond to MCI commands issued by 
your application (see Figure 2). Your application actually ad¬ 
dresses them by their device type names or device element 
names. 


How to Obtain the Digital 
Video Specification 

The final version of the specification and an early version 
of the VCR command set are now available. Contact: 

Matt Saettler, Product Manager 
Multimedia Systems Group 
Microsoft Corporation 
One Microsoft Way 
Redmond, WA 98052 
(206) 936-8644 
FAX: (206)936-7329 
email: matts@microsoft.com 

These specifications are also available in electronic form from: 
anonymous FTP at ftp.uu.net:.vendors\microsoft\multimedia 
WINSDK forum of CompuServe 

Microsoft Multimedia File download BBS at (206) 936-4082 


Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He is a contributing editor for 
Windows/DOS Developer's Journal. He is currently employed as Software Engineer at Cimage Corporation of Ann Arbor, Michigan. 
He can be reached directly at the HAL 9000 BBS (313) 663-4173 or as vrv@cimage.com on Usenet. 
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The device type name consists of 
the device type and unit number. For 
example, the first CD-ROM player would 
be addressed as cdaudiol, the second 
CD-ROM as cdaudio2, and so on. The 
unit number is omitted when only one 
physical device is present (e.g., 
cdaudio). The entire listing of logical 
names must be defined in the [mci] 
section of your SYSTEM. INI file. This ex¬ 
ample following includes four drivers: 


[mci] 

cdaudio=mcicda.drv 
waveaudio=mciwave.drv 
videodisc=mcipionr.drv 
digitalvideo=mcidvavi.drv 

You may substitute the device element 
name for the device type name when 
using compound devices. A compound 
device is any multimedia device which 
can use external files. A simple device 
only works with physical media rather 


than files on your hard disk. For ex¬ 
ample, the compound waveform device 
records and plays sounds into a .WAV 
file. Flowever the simple vcr device 
records and plays video only through its 
medium (i.e., videotape). The exact file 
extension, such as .WAV for waveform, 
determines the device association. The 
[mci extensions] section of the SYS¬ 
TEM. INI file enumerates all of these as¬ 
sociations. The [mci extensions] list¬ 
ing for the devices in the [mci] sample 
above would include only the .WAV and 
.AVI entries, since they correspond to 
the only compound devices. 

[mci extensions] 

wav=waveaudio 

avi=digitalvideo 

The .AVI extension refers to Microsoft's 
own Audio Video Interleave (AVI) for¬ 
mat. Support for other vendor-specific 
formats, such as Intel’s Digital Video In¬ 
terleave (DVI) format may also be 
present. 

Since MCI was designed exclusively 
for Windows, it follows a message- 
based interface that fits the Windows 
application structure well. The MCI inter¬ 
face consists of about three dozen new 
messages plus six extra function calls 
(see Figure 3). Your application can issue 
commands either directly as messages 
or indirectly via strings. The former 
works best with applications designed 
specifically to control multimedia 
devices. The latter works well with 
script-based applications and casual 
uses of multimedia. However, both 
methods offer equivalent functionality. 
For example, a message called MCI_F00 
could also be expressed as the command 
string foo. In the following sections, I dis¬ 
cuss the specifics of both approaches. 

MCI Message Interface 

Multimedia applications submit all 
MCI messages directly through the mci- 
SendCommand() function. This function 
communicates with multimedia devices 
in much the same way that SendDlg- 
Message() communicates with dialog 
box controls. The first parameter to 
mciSendCommandO is DevicelD, which 
specifies the handle of the device you 
want to act on the command. The w- 
Message parameter tells the device 
which command to execute (e.g., 
MCI_0PEN). The dwParaml parameter 
(text continued on page 9) 
September 1992 


Figure 1 



(videodisc) (digitalvideo) (vcr) 


Sample MCI Configuration 


Figure 2 


Device Type 

Device Driver Included 

Device Description 

cdaudio 

MCICDA.DRV 

Compact Disc audio 

dat 

* 

Digital audio tape 

digitalvideo 

* 

Digital video cap./play 

mmmovie 

MCIMMP.DRV 

Macro Mind movie player 

other 

* 

Undefined 

overlay 

* 

Analog video overlay 

scanner 

* 

Image scanner 

sequencer 

MCISEQ.DRV 

MIDI sequencer 

vcr 

* 

VCR record and/or play 

videodisc 

MCIPIONR.DRV 

Pioneer LD-V4200 

waveaudio 

MCIWAVE.DRV 

waveform 

* indicates driver not included, contact vendor 

Device Types and Drivers from Multimedia for Windows 1.0 
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Figure 3 


BOOL mciExecute(lpstrCommand); _ 

WORD mciGetDevicelD(lpstrName); _ 

WORD mciGetErrorString(dwError, IpstrBuffer, wLength); _ 

WORD mciSendCommand(wDevicelD, wMessage, dwParaml, dwParam2); _ 

WORD mciSendString(lpstrCommand, IpstrReturnString, wReturnLength, hCallback); 
WORD mciSetYieldProc(wDevice1D, fpYieldProc, wReturnLength, hCallback); 


MCI Function Prototypes 


Figure 4 

MCI Command 
String 

Digitalvideo 

Waveform 

(Audio) 

Overlay (Video) 

capture 

yes 

no 

no 

copy 

yes 

no 

no 

cut 

yes 

no 

no 

list 

yes 

no 

no 

monitor 

yes 

no 

no 

paste 

yes 

no 

no 

quality 

yes 

no 

no 

realize 

yes 

no 

no 

reserve 

yes 

no 

no 

setaudio 

yes 

no 

no 

setvideo 

yes 

no 

no 

signal 

yes 

no 

no 

step 

yes 

no 

no 

undo 

yes 

no 

no 

update 

yes 

no 

no 

freeze 

yes 

no 

yes 

load 

yes 

no 

yes 

put 

yes 

no 

yes 

unfreeze 

yes 

no 

yes 

where 

yes 

no 

yes 

window 

yes 

no 

yes 

cue 

yes 

yes 

no 

delete 

yes 

yes 

no 

pause 

yes 

yes 

no 

play 

yes 

yes 

no 

record 

yes 

yes 

no 

resume 

yes 

yes 

no 

seek 

yes 

yes 

no 

stop 

yes 

yes 

no 

capability 

yes 

yes 

yes 

close 

yes 

yes 

yes 

info 

yes 

yes 

yes 

open 

yes 

yes 

yes 

save 

yes 

yes 

yes 

set 

yes 

yes 

yes 

status 

yes 

yes 

yes 

MCI Functions Supported by Class 


- New Version 4.5 \ - 

Commenting Disassembler! 


Sourcer,. 


□ See how programs work 

□ Easily modify programs 

"Sourcer is the best disassembler 
we’ve ever seen." pc Magazine 


SOURCER “ creates commented source 
code and listings from executable files or 
memory, suitable for reassembly. Sourcer 
helps clarify the inner workings of programs, 
with detailed in-line comments on interrupts, 
subfunctions, I/O ports functions, and much 
more. It offers complete support for all 
8088/87 to 80486 instructions and V20/V30. 
Sourcer provides the most comprehensive 
automatic analysis available to accurately 
separate code and data. It determines data 
types, uses descriptive labels for BIOS and 
PSP data, and links data items across 
multiple segments. Now supports MASM 
6.0, TASM and DOS 5.0. 

Professionals consistently chose Sourcer 
because of its ability to achieve far superior 
results with the least effort. 


Windows 


Windows Source™ works with Sourcer to 
generate detailed listings of Windows EXEs, 
DLLs, VxDs, and OS/2 files. See the actual 
Windows module names used in the programs 
you analyze. Learn the undocumented 
Windows functions used by the professionals 
to perform tricks that are otherwise impossible. 
Purchase with Sourcer and save $30. 


BIOS Source 


for PS/2, AT, XT, PC and Clones 

□ Change and add features 

□ Clarify Interfaces 

The BIOS Pre-Processor™ augments Sourcer 
to obtain commented listings for any BIOS 
ROM in your PC. Now you can understand 
how your specific BIOS works. Adds over 
75K of comments specific to your BIOS. 
Tracks and identifies multiple interrupt 
branches with special labeling such as 
"int_10_video." Full automatic operation. 


Sourcer -Commenting Disassembler $129.95 

BIOS Pre-Processor 49.95 

Sourcer w/BI0S-(save $10) 169.95 

Unpacker -Unpacks packed files 39.95 

View-lt -View 132 column files 69.95 

ASM ProPak I -All above (save $40) 249.80 

ASMtool 486 -Automatic flowcharter 199.95 

ASM ProPak II -All above (save $90) 399.75 


ASM Checker -Finds source code bugs 179.95 
ASM ProPak III -All above (save $120) 549.70 
Windows Source -requires Sourcer v4.5 129.95 

Windows Source and Sourcer _229.90 

Shipping: USA $6; Canada/Mexico $10; Other $18. CA residents 
add sales tax. © 1992 VISA/MasterCard/COD accepted. 

30-DAY MONEY-BACK GUARANTEE 

1-800-648-8266 

m—~jrj V Communications, Inc. 

\\V W 4320 Stevens Creek Blvd., Suite 275 

San Jose, CA 95129 FAX 408-296-4441 
V 408-296-4224 
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New Products 

Industry-Related News & Announcements 


WindowsMAKER v4.0 Features New Architecture 


Blue Sky Software Corporation has released 
WindowsMAKER Professional v4.0, a new version of their in¬ 
teractive GUI design tool for Windows 3.x programmers. 

Major improvements in this version include easy migration 
for programmers switching between languages, compilers, 
and platforms, and increased ease of use. 

WindowsMAKER Professional is an object-oriented 
prototyping and development tool. You can use it to interac¬ 
tively design your application’s user interface, then generate 
the code to implement that interface. You can make your 
own modifications to the generated code and still return to 
the prototyper to make user interface changes without 
losing the custom code you added. 

This version allows you to select one of several Switch-lt 
code generation modules, to provide language and compiler 
independence. Blue Sky offers separate code generation 
modules for ANSI C (which works with Borland, Microsoft, Zor- 
tech, and Watcom C compilers), Microsoft's C++ Foundation 


Borland Ships TPW vl.5 

Borland International, Inc, has released a new version of 
Turbo Pascal for Windows. Turbo Pascal for Windows (TPW) 
is an integrated Windows development environment for 
creating Windows 3.x applications written in Pascal. This ver¬ 
sion lets developers take advantage of new Windows 3.1 fea¬ 
tures, including OLE, common dialogs, drag-and-drop, and 
Truetype fonts. 

Besides direct access to the Windows 3.1 API, TPW 
provides ObjectWindows, a high-level, object-oriented API 
that reduces the amount of coding required for creating Win¬ 
dows user interfaces by offering predefined objects for win¬ 
dows, menus, dialogs, controls, data management, and 
more. This version includes Borland's Resource Workshop, a 

Dyad Premiers Two C++ Libraries 

M++ Array is a new C++ class library that handles a 
variety of array operations. The package includes general 
math operations, indexing or sub-array capabilities, random 
number generation, trigonometric and hyperbolic functions, 
exponential and logarithmic functions, generalized array 
manipulations, statistical operations, fundamental matrix 
operations such as inner products, general matrix inversion, 
linear least squares, and equation solution, and more. All 
these operations can be performed on multidimensional ar¬ 
rays with compile- and runtime testing of array conformance. 

M++ QUAD is a new C++ class library that works with 
Dyad's M++ Scientific class library to allow integration of one- 
or two-dimensional functions over finite or infinite limits. 

The functions can be continuous, discontinuous, or infinite. 


Classes (MFQ, Borland's C++ OWL, Windows NT 32-bit code, 
OS/2 PM, XVT (which supports multiple platforms), and Turbo 
Pascal for Windows. 

User interface improvements include a new toolbar that 
makes your most common selections directly available in 
the main window. The new version provides point and click 
selection of custom controls from DLLs, even from DLLs con¬ 
taining multiple controls. This version supports Borland’s cus¬ 
tom controls and can capture menus, in addtion to dialog 
boxes, from any Windows program. 

WindowsMAKER v4.0 costs $995 and is royalty-free. 
Registered users can upgrade for $315. The package includes 
the Switch-lt ANSI C code generation module; each additional 
Switch-lt module costs $495. For more information, contact 
Blue Sky Software, 7486 La Jolla Blvd., Suite 3, La Jolla, CA 
92037, (619) 459-6365 or (800) 677-4WIN; FAX (619) 459- 
6366. 


graphical design tool for interactively creating resources 
(dialogs, bitmaps, cursors, and so on). The package includes 
an updated version of the Turbo Debugger for Windows, a 
speedbar for quick access to common functions, and color 
syntax highlighting to make code more readable. The new 
package includes programs that demonstrate Windows 3.1 
features and support for SuperVGA and IBM 8514 monitors. 

Turbo Pascal for Windows vl.5 is compatible with Win¬ 
dows 3.0 and Windows 3.1 and costs $149.95; an upgrade 
costs $49.95 (call 1-800-UPGRADE). The Microsoft Windows 
SDK is not required. For more information, contact Borland 
International, Inc., 1800 Green Hills Road, P.O. Box 
660001, Scotts valley, CA 95067-0001. 


The programmer can select the integration rule, the end¬ 
points, the number of points, and the error criteria. The in¬ 
tegration procedure is based on the adaptive Gauss-Konrod 
quadrature rules available in QUADPACK (a popular FORTRAN 
library). Non-adaptive rules can also be selected. 

M++ Array costs $119 and is available for Borland C++, 
Microsoft C++, and Symantec (Zortech) C++. M++ QUAD costs 
$195 for DOS and $245 for UNIX single-user systems. M++ 
QUAD requires M++ Scientific, which comes with source and 
costs $495 for DOS and $695 for UNIX single-user systems. 

For more information, contact Dyad Software Corporation, 
515 116th Avenue NE, Suite 120, Bellevue, WA 98004, 

(800) 366-1573 or (206) 637-9426; FAX (206) 637-9428. 

(continued on page 65) 
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(text continued from page 6) 

holds the OR'ed set of flags pertaining to the message (for ex¬ 
ample, the MCI JEST flag asks the device whether it supports the 
message in question). The dwParam2 parameter actually points to 
an associated parameter structure. The structure itself depends 
on the specific command and device class (opening a digital- 
video device, for example, would require a pointer to a 
MCI_DGV_OPEN_PARMS structure). The Digital Video MCI specifica¬ 
tion uses the names l Pa rami and lParam2 to refer to what used 
to be called dwParaml and dwParam2 respectively. 

The mciSendComandO function returns a DWORD error code 
pertaining to the submitted command. The mciGetError- 
StringO function interprets the error code and sets the 
IpstrBuffer parameter to an error text string. Your applica¬ 
tion can then display the error string in a dialog box or log file. 
If it cannot interpret the error code, mciGetErrorString() 
simply returns FALSE. 

MCI String Interface 

The MCI string interface uses a high-level syntactic ap¬ 
proach for issuing commands. The basic syntax conforms to 
the following verb/noun model: 

<command> <device_name> <arguments> 

The command represents the action performed, such as open, 
play, or freeze. The device_name can contain either the MCI 
device type string (e.g., cdaudio), a device element filename 
(e.g., hal9000.wav), or an alias specified by a prior open com¬ 
mand. As you might expect, the arguments further define the 
command. Most MCI command strings resemble English-like 
sentences. For example, 

"setvideo digitalvideo source to ntsc number 2" 

switches in the second NTSC (composite) video input as the 
source for digital video recording. The actual video feed might 
originate from a video camera, manually operated VCR, or 
even another MCl-controlled video device. 

The mciSendStringO function submits the actual com¬ 
mand strings. The first parameter, IpStrCommand, points to the 
command string. The IpReturnString parameter points to a 
string for storing return information. The next parameter tells 
the maximum size of the IpReturnString. Last, the h- 
Callback parameter contains the window handle where any 
notification messages should arrive. The error codes returned 
by mciSendStringO can also be decoded by the mciGet- 
ErrorTextf) function mentioned earlier. 

Alternately, you can call mciExecutef) on your command 
strings and MCI will report any errors in a message box. The 
mciExecute() function takes the command string as its only 
parameter and simply returns a Boolean success value. The 
mciExecuteO function allows an application to take ad¬ 
vantage of multimedia without having to know anything 
about it. For example, suppose you had written a pop-up 
alarm clock program. If the user could attach an MCI com¬ 
mand file to an alarm, then he could write an MCI command 
file to play CD-ROM music as the alarm. 

Notify and Wait 

All MCI commands, whether issued as strings or messages, 
immediately return control back to the calling application. This 


enables your application to continue unimpeded while one or 
more multimedia devices work asynchronously. Depending on 
the nature of the device and the operation, it might require 
anything from a few milliseconds to several minutes to finish. 
However, MCI also recognizes the need for applications to 
synchronize with the multimedia device and observe its 
progress. MCI addresses this requirement with the MCI_NOTIFY 
and MCIJWAIT flags. You may apply these optional flags to 
every possible MCI command. The digitalvideo class also in¬ 
cludes a special notification command called MCI_SIGNAL 
which I'll describe later. 

The MCIJOTIFY flag tells the multimedia device to call 
your window handler back when the requested operation 
completes. However, since MCI does not support an arbitrary 
queue of pending notifications, only one concurrent notifica¬ 
tion per device is permitted. The callback message 
MM_MCINOTIFY responds with wParam set to the notification 
result and IParam to the responding device ID. 

If wParam is MCI_NOTIFY_ABORTED, then a conflicting com¬ 
mand prevented an earlier command from completing. For ex¬ 
ample, if you issued a lengthy MCI_PLAY command (with 
MCI_NOTIFY flag) followed immediately by an MCI_ST0P com¬ 
mand, then MCI_NOTIFY_ABORTED applies. If wParam is 
MCI_NOTIFY_SUCCESSFUL, then the command completed nor¬ 
mally (however, Petzold (1992) reports some anomalous behavior 
for this flag). If wParam is MCI_NOTIFY_SUPERSEDED, then the 
device received another non-conflicting command which also 



fracta 


Uonsider the fern. This intricate plant 
spawned the discovery of 
Fractal Transform™ Technology 
and fractal image compression; today's 
most powerful image compression 
technology. 

Consider POEM ColorBox 
This new SDK harnesses 
fractal technology for 
Windows 3.x developers. 
DLLs provide a complete 
imaging environment 
including ultra-high 
compression, resolution 
independent images, fast 
decompression and high 
quality 24-bit color rendering. 

Whether you program in C or Visual 
Basic, POEM ColorBox is comprehen¬ 
sive, easy-to-use, and at $499, 
surprisingly affordable. 

Call or write today for a free demo 
disk. Learn why POEM ColorBox is the 
solution to your image compression 
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Iterated Systems 

5550-A Peachtree Pkwy., Suite 650 
Norcross, GA 30092 
Tel: (404)840-0310 
Fax: (404) 840-0806 
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Figure 5 

MCI Command Group 

Related MCI Commands 
(string notation) 

Record/Playback Video 
Sequence 

cue, pause, play, record, 
resume, reserve, save, seek, 
signal, step, stop 

Capture/Display Still Frame 

capture, freeze, unfreeze, 
load, save 

Video Window Control 

put, update, where window 

Multimedia Clipboard 

copy, cut, delete, paste, undo 

Presentation Source Control 

monitor, setaudio, setvideo 

Operational Parameters 

capability, close, info, list, 
open, quality, realize, set 
status 

MCI digitalvideo Commands Grouped by Functionality 


requested notification. Last, a value of MCI_NOTIFY_FAILURE in¬ 
dicates the inability of the device to complete the command. 

The MCIAIT flag blocks the calling application until the 
device completes the command. If you wish to display status 
messages or perform other processing while your application 
is blocked, you can register a yield procedure with mciSet- 
YieldProc() (see Figure 3). Your yield procedure receives a 


AccuSoft 

Image Format Library 

TIFF, PCX, TARGA, GIF, DIB, BMP, WMF,WPG 


Import, export, convert, display, & print all eight formats. Both DOS libraries 
and Windows DLL included in one low priced, royalty free, package. 
Sample applications with complete source code included. Support for all 
eight formats can be achieved with a single function call! The libraries handle 
everything from detecting the file type to handling all flavors of file encoding. 
Up to 24 bits/pixel. These libraries are used by several major software 
companies. Source code available. Don’t settle for anything less. 



Windows DLL included 


Only $295 

Plus Shipping 


No 

Royalties 



DOS libraries included 


• Supports all major C&C++ languages including Microsoft, Borland, 
Watcom, and Metaware. 

• Supports all Windows languages including Visual Basic, Turbo Pascal 
for Windows, Smalltalk, Actor, etc. 


Order Hotline (800) 525-3577 

Call for full details by FAX 


30 day satisfaction guarantee! 

160 E. Main St. (508) 898-2770 

Westboro, MA 01581 (508) 898-9662 (fax) 


AccuSoft 

C o r p ora t i o n 
Precision crafted software' 
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wDevicelD and dwData parameters back from the device 
driver. However, there are no guarantees concerning how 
often it will be called. If the multimedia device is CPU-inten¬ 
sive, then lengthy processing by your yield procedure could 
impede its performance. 

Digital Video and MCI 

The MCI digitalvideo device class primarily displays and 
captures compressed motion video sequences. A digital- 
video device must also support the recording and playback of 
digital audio and still video frames. Accordingly, digitalvideo 
should share many capabilities with the waveform (digital 
audio) and overlay (analog video) device classes. An overlay 
device primarily displays live video in a window: it cannot 
record or playback multiple video frames from a file in real 
time. However, overlay devices may be able to freeze and 
save a video frame into a file. 

Since MCI reuses the same basic command keywords for 
all three classes, you can compare and contrast their 
functionality (see Figure 4). Some important conclusions can be 
drawn from the vocabulary of each device class. First, the 
digitalvideo class is a functional superset of the waveform 
and overlay devices. Second, the digitalvideo class sig¬ 
nificantly extends MCI by adding a dozen unique command 
keywords. In the remainder of the article, I discuss both the 
unique keyword extensions and the new semantics of the 
original keywords for digitalvideo. Functionally speaking, the 
commands involve capabilities and limitations, playing and 
recording video, still capture and freeze, controlling video win¬ 
dows, interacting with the clipboard, and controlling the over¬ 
all presentation (see Figure 5). 

Capabilities and Limitations 

Although the digitalvideo device class sports a rich com¬ 
mand set (see Figure 4), this does not imply that every im¬ 
plementation supports the full set. Rather, the digitalvideo 
device class enables a spectrum of support from software-only 
playback devices to full-fledged real-time video acquisition 
hardware adapters. This is very similar to how the waveform 
device can operate with devices as crude as the PC's audio 
speaker [SPEAKER. DRV) or as sophisticated as a dual-channel 
stereo music adapter (e.g., SoundBlaster Pro). For example, 
Media Vision's MotiVE software-only playback system can 
deliver digital video displays of up to 320x200 at 15 
frames/second (Rosenthal, 1992). The MCI CAPABILITY com¬ 
mand reports on the availability of each individual feature in 
the current implementation (see Figure 6). 

Furthermore, even the feature map provided by 
MCI_CAPABILITY is insufficient to describe specific implemen¬ 
tation-based restrictions. For example, the can reverse 
capability query cannot distinguish between single-step 
reverse and full-speed reverse playback. The digitalvideo 
class clarifies this by introducing the MCI_TEST flag. The 
MCI_TEST flag can be applied to any valid command string. In 
the example above, two distinct queries entirely resolve the 
ambiguity: 

step reverse test 

and 
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play reverse test 


The digitalvideo specification portends extension of the 
MCI_TEST flag in future implementations. The command string 
capability can test queries its availability in any particular 
implementation. 

Record and Play Video 

The display and capture of motion video sequences in the 
digitalvideo class mirrors the playback and recording of 
audio in the waveform class. The waveform class is based on 
command verbs that mostly mimic the controls on a cassette 
tape recorder. Accordingly, both digitalvideo and waveform 
use the following command messages: MCI_CUE, MCI_0PEN, 
MCI_PAUSE, MCIJLAY, MCI_RECORD, MCIJESUME, MCI_SAVE, 
MCI_SEEK, and MCI_ST0P. The digitalvideo class also allows 
the MCI_STEP message, which is not supported in the 
waveform class. Last, the MCI_RESERVE and MCI_SIGNAL mes¬ 
sages are unique to digitalvideo. I’ll briefly describe the im¬ 
plications of all of these messages for digitalvideo. 

The MCI_CUE message prepares any multimedia device for 
playback or recording. Although you may issue MCI_PLAY or 
MCI_RECORD without ever calling MCI_CUE, a significant delay 
may be incurred before the device can react appropriately. 
The MCI_CUE command automatically switches the device 
from a stopped state to a paused state. When cueing for input, 
the MCI_CUE also causes an implicit MCI_RESERVE operation. 

Since video recording requires significant disk storage, 
reserving enough workspace in advance helps ensure success¬ 
ful recording. The MCI_RESERVE message tells MCI to set aside 
a specified amount or return an error code if insufficient disk 
space is available. You can specify both the path and the size 
of the workspace file. The size must be specified in the cur¬ 
rent time format: milliseconds, SMPTE encoding, or raw bytes. 

Storing digital video often requires more than 20 times as 
much space as digital audio alone. For example, storing an 
image 1/16th the size of the VGA screen (160x120) with 256 
colors at 10 frames/second would consume at least 200Kb per 
second (Rosenthal, 1992). Full-screen video at a flicker-free 
rate (30 frames/second) would require more bandwidth than 
current CPUs, busses, and disk controllers can handle. 

After cueing and reserving space, an MCI_RECORD message 
starts the actual video compression and capture. A recording 
session continues to run until it reaches the specified frame 
boundary or the device receives an MCI_ST0P or MCI_PAUSE 
message. If interrupted by MCI_PAUSE, recording can continue 
immediately after an MCI_RESUNE message is sent. The 
recorded sequence can begin at any position in the 
workspace and can either overwrite existing frames or replace 
them. An optional clipping rectangle can trim the active 
recording area. 

Once captured, a video sequence can be displayed with 
MCI_PLAY. Any desired portion of the workspace can be 
played back. In adddition, digitalvideo devices can play in 
reverse. Reverse playback is also available on mmmovie (Macro- 
Mind animation) and videodisc (LaserDisc) devices but not on 
waveform devices. The digitalvideo device class uniquely 
supplies an infinite repeat option for playing. 


Figure 6 

MCI 

Command 

capability 

Digitalvideo 

Waveform 

(Audio) 

Overlay 

(Video) 

can eject 

no 

no 

no 

can freeze 

optional 

no 

optional 

can lock 

optional 

no 

optional 

can play 
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optional 

no 

can record 

optional 

optional 

no 

can reverse 

optional 

no 

no 

can save 

optional 

optional 

optional 

can stretch 

optional 

no 

optional 

can test 

optional 

no 

no 

has audio 

optional 

yes 

optional 

has video 

optional 

no 

yes 

uses files 

yes 

yes 

optional 

uses palettes 

optional 

no 

no 

MCI Capabilities Supported by Class 


With the MCI_SIGNAL command, your application can re¬ 
quest that it receive special notifications periodically during 
video playback. The MCI_SIGNAL command reports in a similar 
fashion as the MCI_NOTIFY flag, but operates through an en¬ 
tirely independent mechanism. Most notably, several 
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MCI_SIGNAL commands may be enqueued simultaneously, 
whereas only one MCI_NOTIFY flag may be pending on a 
given device operation. Specifically, MCI_SIGNAL sends a 
MM_MC I SIGNAL message to a callback window procedure each 
time the device plays past user-defined positions. The starting 
position and intervals between signals are specified in the cur¬ 
rent time format. When issuing MCI_SIGNAL, you specify 
whether MM_MCISIGNAL is to return your user-defined value or 
the exact position mark. Once established, signals remain live 
until the workspace is altered (e.g., through MCI_RECORD) or 
they are explicitly cancelled. 

The digitalvideo device can position the workspace and 
cue it with the MCI_SEEK command. However, since video 
compression algorithms may store frames with variable-length 
encoding and interframe encoding, seeking to an exact posi¬ 
tion requires intensive computation. Variable-length encoding 
implies that the size of an individual frame varies with how 
well it compresses. Interframe encoding implies that the con¬ 
tents of a frame are defined by a reference frame plus the 
differences of intervening frames. A digitalvideo device may 
maintain a frame directory with more detailed frame indexes. 
However, building the frame directory can also be a time-con¬ 
suming process. The default seek mode does not enforce 
exact frame seeks and should be used whenever possible. 

Playback on digitalvideo devices normally occurs at real¬ 
time speed (30 frames per second), but you can adjust the 
playback rate with the MCI_SET message and the 
MCI_DGV_SET_SPEED flag. A digitalvideo device is also 
capable of moving forward or backward a frame at a time; 
you use the MCI_STEP message to advance or reverse the 
device by one frame or a specified number of frames. Al¬ 
though a single-step in a motion video may appear visually 
identical to a video still, the digitalvideo class makes some 
important distinctions between them. 

Still Capture and Freeze 

As I mentioned earlier, the digitalvideo device class 
provides a superset of the functions found in the less sophisti¬ 
cated analog overlay video device. Therefore, digitalvideo 
emulates the MCIJREEZE, MCI JO AD, MCI JUT, MCIJN FREEZE, 
MCIJHERE, and MCIJINDOU commands (see Figure 4). Another 
command, MCIJAPTURE, is unique to the digitalvideo class. 
Each of these functions has a role in the capture, display, and 
storage of still frame video. 

The MCIJREEZE command immediately stops the update 
of the frame buffer from the presentation source. The presen¬ 
tation source itself, such as a video camera, remains unaf¬ 
fected and continues to roll. The complementary MCIJN- 
FREEZE command restores the frame buffer to its regular cap¬ 
ture rate. Optionally, a lock mask" can set the freezing area 
to an arbitrary clipping rectangle. Note that MCIJREEZE is not 
a required function and may be omitted on purely analog 
overlay devices. 

Once the frame buffer is frozen, the generic MCIJAVE com¬ 
mand can write it out to disk (again, MCIJAVE is not a re¬ 
quired function and may not be physically supported on all 
overlay devices). The overlay class uses the MCIJ0AD com¬ 
mand to fetch a previously saved frame buffer from disk and 
bring it into the workspace. All other MCI compound devices use 
the MCIJPEN command rather than MCIJ0AD to bring in files. 


The MCIJAPTURE message, unique to digitalvideo, effec¬ 
tively combines MCIJREEZE and MCIJAVE in a single shot. It 
immediately grabs the contents of the frame buffer and stores 
it in the specified file. If the device is busy playing a motion 
video sequence, then, depending on the implementation, the 
MCIJAPTURE request may be disallowed. If the device can ac¬ 
commodate frame capture during playback, a momentary 
pause or audio/video glitch may appear briefly, again, depend¬ 
ing on the implementation. The captured data is saved using 
the current file format, compression algorithm, and quality 
level. 

Video Window Control 

In addition to still capture, digitalvideo devices also emu¬ 
late the video window control functions as defined for over¬ 
lay devices. The window control commands MCIJUT, 
MCIJHERE, and MCIJINDOU work the same way regardless of 
whether still frame or motion video passes through the frame 
buffer. 

The MCIJUT command can redefine the video, frame, 
source, and destination rectangles. By default, the entire video 
picture is digitized into the frame buffer and is then copied to 
the destination window. The video rectangle refers to the ex¬ 
ternal input source and allows clipping before the image is 
sent to the frame buffer. The frame rectangle refers to the 
area within the frame buffer that your application is inter¬ 
ested in. The source rectangle refers to the portion of the 
frame buffer that your application wants to display. Last, the 
destination rectangle refers to the portion of the window 
where the source rectangle image will be displayed. At any 
stage where the rectangles differ in size, the device is ex¬ 
pected to scale as best it can. However, the stretching 
capability is strictly optional (see Figure 6); if it is not available, 
the result may be undersized or overly clipped output. 

The MCIJHERE message complements MCI_PUT. This mes¬ 
sage queries the device for the coordinates of the video, 
frame, source, or destination rectangle. The coordinates of the 
video and frame rectangles are given in device-specific and 
frame-buffer coordinates, respectively. 

Last, the MCIJINDOU command can redirect the video out¬ 
put from the default window created by the device to any 
other window. MCIJINDOU can hide, iconify, minimize, maxi¬ 
mize, or activate the window, and allows you to set the cap¬ 
tion (i.e., window title) as well. Once the output has been 
redirected, your application must take responsibility for han¬ 
dling resize events. 

Multimedia Clipboard 

The Digital video MCI specification includes the first intro¬ 
duction of multimedia to the clipboard. The specification 
defines access to the clipboard through the MCIJOPY, 
MCIJUT, MCIJELETE, MCIJASTE, and MCIJND0 commands. 
Depending on the implementation, the clipboard functions 
may operate either against the standard Windows clipboard 
or against a special private clipboard. 

First, the MCIJUT and MCIJOPY messages manipulate a 
sequence of video frames within the current workspace. 
These messages cut and copy whole frames of video by 
default. However, you can also specify a clipping rectangle to 
trim down the active video area. In addition to the video 
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Presentation Control 

The MCI JON I TOR, MCIJETVIDEO, 
and MCI_SETAUDIO commands together 
act like a patch-panel to control the 
presentation source of video and audio. 
All three commands are unique to the 
digitalvideo device class. The 
MCI_M0NIT0R message specifies whether 
the presentation source is internal 
(workspace file) or external. For ex¬ 
ample, a video camera or VCR con¬ 
nected to the SuperVHS inputs of the 
digital video hardware would be con¬ 
sidered an external source. You can 
monitor the video stage before com¬ 
pression, after compression, or directly 
from the source. 

The MCIJETVIDEO selects external 
sources, modifies video signals, sets 
recording rates, and chooses the still 
and motion compression algorithms. 
First, although the actual external sour¬ 
ces supported depend on the hardware, 
the digitalvideo device allows rgb, 
pal (European), ntsc (U.S. composite), 
svideo (SuperVHS), and secam 
(European) inputs. A separate source 
number parameter selects which of 
several possible inputs to use (e.g., ntsc 
input #2). 

Second, this command can modify 
video signals by selectively adjusting 
brightness, saturation, contrast, gamma 
correction, sharpness, or tint. Adjust¬ 
ments can occur immediately or can be 
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frame sequence, your cut or copy operation should also post 
a Device-Independent Bitmap (DIB) image of the first frame to 
the standard Windows clipboard. This permits a far greater 
range of applications to take advantage of your data. 

The MCI_DELETE message is similar to the cut operation, 
but affects only the current workspace and leaves the clip¬ 
board intact. Both MCI_DELETE and MCI_C0PY black out the 
area defined by the clipping rectangle in the source 
workspace. The clipping rectangle must be omitted to actually 
remove an entire range of frames from the workspace. 

The MCI_PASTE message copies data from the clipboard 
into the workspace. The frames can be pasted starting at any 
position within the current workspace. The MCI_PASTE_INSERT 
and MCIJASTEJVERURITE flags tell whether the existing 
frames will be moved or replaced. An optional destination rec¬ 
tangle allows the frames to be both 
translated and scaled as they are 
copied. 

Last, the MCI_UND0 message rever¬ 
ses the effects of the most recent 
MCI JUT, MCIJOPY, MCIJELETE, or 
MCI_PASTE. Your application should in¬ 
clude an alternate means of recovery if 
MCIJNDO is not supported or has 
limited capabilities in an implementation. 


spread out over an arbitrary time period for more subtle video 
effects. The resolution of each characteristic can be specified 
to 1/10th of one percent, although the actual hardware may 
have less control. 

MCIJETVIDEO can also configure the exact recording rate 
(frames per second) with similar resolution. Last, the compres¬ 
sion algorithms for still frame and motion video can be set 
independently. 

The digitalvideo class defines three distinct levels of 
quality for still frame capture: good, better, and best. The 
MCIJIST message, unique to the digitalvideo class, can 
return the list of supported compression types. 

Real-time video special effects are absent from the presen¬ 
tation control and other functional groups. Hooks to provide 
standard or device-dependent video wipes could have been 
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provided. A video wipe typically provides the transition be¬ 
tween one presentation source and another - for example, 
making one picture fade out while the other simultaneously 
fades in. Support for these types of effects requires specialized 
hardware, such as the VideoToaster for Amiga, that is not yet 
widely available in the PC arena. 

The MCI_SETAUDIO message controls the audio portion of 
the program just as MCI_SETVIDEO controls video. Accordingly, 
it can select the input source, adjust audio signal parameters, 
and choose the audio compresssion algorithm. The external 
audio inputs are limited to a choice of one signal - from the 
left channel, right channel, average of L+R, or stereo channel. 
This command also adjusts the bass, treble, left volume, right 
volume, and combined volume. These controls are far less 
sophisticated than those you might see in an inexpensive 
analog audio equalizer. 

Conclusion 

Following by one year the introduction of the Multimedia 
Extensions 1.0 for Windows, digital video is an admittedly late 
entrant to the multimedia stage. The digital video implemen¬ 
tation both follows and extends existing Windows Media Con¬ 
trol Interface standards. The digitalvideo device class emu¬ 
lates the waveform and overlay devices, plus adds further 
controls for motion video capture and playback. Other 
digitalvideo additions, such as the multimedia clipboard, sig¬ 
nalling, and command testing, are almost certain to appear 
soon in other device classes. The device-independent design 
and simplicity of the Windows MCI take most of the work out 
of handling media, so developers can concentrate more effort 
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on their applications. Whether your application needs just 
simple video playback or a whole video studio, MCI merits 
serious consideration. 
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Real-Time Programming 


Using the 146818 Real-Time Clock Chip 


Jeffrey C. Foster 


Most control systems require a periodic 
pulse to establish a time base for the system. 
This time base can be used for generating an 
internal dock, running control loops, or driving 
a preemptive operating system. In this article I 
explore two methods of providing this function 
on an IBM AT-compatible computer. Both 
methods use the 146818 Real-Time Clock Plus 
Ram Chip. The first method uses the AT BIOS 
support functions-, the second programs the 
146818 directly. The test programs are written 
in C with the Turbo C++ 2.0 compiler. 

The first method uses the cassette interrupt 
(15H) function —Set Flag after Time Interval. To 
use this function, you tell the BIOS the address 



of a flag byte and how many microseconds to 
wait before setting a flag. The delay interval is 
passed in registers CX, DX and the address of 
the flag is passed in ES:BX. When the time in¬ 
terval has expired, the BIOS will set bit seven of 
the flag byte. While the BIOS call specifies the 
time in microseconds, the actual resolution 
available is about one millisecond. This is be¬ 
cause the interrupt rate is set to 1024 times 
per second. At each interrupt the BIOS sub¬ 
tracts 976 from the delay time. 

To implement this method, first clear the 
flag byte, then tell the BIOS the delay time and 
the flag address. Finally, wait in a polling loop 
for the flag to be set by the BIOS (see Listing 1). 
This method allows you to measure 
realtime without having to write an in¬ 
terrupt handler and lets you specify the 
time interval with a resolution of one 
millisecond. However, the software will 
have to check the alarm flag by polling 
to determine when the time interval is 
over. 

When the program terminates, it 
needs to stop the last set flag function. 
It can either wait for the last time 
period to expire or tell the BIOS to ter¬ 
minate the set flag function. To tell the 
BIOS, call the Set Flag after Delay func¬ 
tion with the AL register set to 1, (see 
clear_flag_wait() in Listing 1). Failure 
to do this may cause abnormal events 
in the next program loaded, as the BIOS 
may modify the program when the last 
time period expires. 


Jeff Foster graduated from the Indiana 
Institute of Technology with a BS in 
Computer Engineering. He currently 
works for the Woodward Governor Com¬ 
pany, designing embedded computer 
systems for control and data acquisition. 
He may be contacted at 1108 Post Drive, 
Rockford, IL 61108. 
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For this first method, the AT BIOS uses the MCI46818 Real- 
Time Clock Plus Ram. Because this chip is also used to main¬ 
tain a machine configuration plus time and date, this is usually 


called the CMOS memory chip. This chip reduces the number 
of DIP switches and jumpers on the motherboard needed to 
configure the the computer. The chip also includes a clock 


Listing 1 


#inc1ude "dos.h" 
linclude "conio.h" 

/**** interrupt occurred flag ****/ 

int time_out; 

/**** Start the event wait flag routine ****/ 
void setup_flag_wait( void); 

/**** Stop the event wait flag routine ****/ 
void clear_flag_wait( void); 

void main( void) 

{/* test program to check out flag wait */ 

/**** clear the screen **•*/ 

clrscrf); 

/**** start initial flag event **»*/ 

setup_flag_wait(); 

/**** until a keypress happens ****/ 

while ( IkbhitO) 

{ 

/**** timer interrupt ? ****/ 

if ( time_out) 
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{ 

setup_flag_wait(); 
putch('T'); 

) 


/**** s top t h e last event wait ****/ 

clear_flag_wait(); 


void setup_flag_wait( void) 

{/* Start set flag after delay function. */ 
/* Call interrupt 0x15 with ah * 0x83 and */ 
/* al = 0. Registers CX, DX is the delay */ 
/* time in microseconds. And BX.ES is a */ 

/* pointer to the flag byte. */ 

/**** Structures for the interrupt call ****/ 
union REGS inregs, outregs; 
struct SREGS sregs; 

/**** Pointer to the flag byte ****/ 

char far* temp = (char far*)&time_out; 

/**** Clear the flag byte ****/ 

time_out ■ 0; 

/**** Load registers for interrupt call ****/ 
inregs.h.ah « 0x83; 
inregs.h.al » 0; 

sregs.es ■ FP_SEG( temp); 
inregs.x.bx = FP_0FF( temp); 
inregs.x.cx ■ 0; 
inregs.x.dx = (unsigned)50000L; 

/»*** Call set flag after delay function »***/ 
int86x( 0x15, iinregs, &outregs, &sregs); 

} 


void clear_flag_wait( void) 

{/* Stop the flag wiat function by calling */ 
/* the interrupt 0x15 with ah = 0x83 and */ 
/* al = 1 */ 

/**** Structures for the interrupt call */ 
union REGS inregs, outregs; 
struct SREGS sregs; 

char far* temp * (char far*)&time_out; 

/**** Load registers for interrupt call ****/ 
inregs.h.ah * 0x83; 
inregs.h.al = 1; 

sregs.es * FP_SEG( temp); 
inregs.x.bx = FP_0FF( temp); 

/***» Call set flag after delay function ****/ 
int86x( 0x15, Sinregs, &outregs, &sregs); 

} 

/* End of File */ 
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(which is why you don't have to set the time and date each 
time an AT-compatible computer is powered up). A 32KHz 
crystal oscillator provides the time base for the chip. An inter¬ 
nal chain of frequency dividers reduces the 32KHz clock fre¬ 
quency to a one Hertz rate. 

Another feature of the chip is its ability to generate peri¬ 
odic interrupts. By programming one of the internal registers, 
you can connect the periodic interrupt to any stage along the 
divide chain. 

The second method for providing a periodic pulse function 
uses the 146818 chip directly. The chip includes fourteen spe¬ 
cial function registers and 50 bytes of RAM (see the sidebar for 
details of the special function registers). 

The registers you need to access are locations OAH, OBH, 
and OCH. Register OAH is used to program the periodic inter¬ 
rupt rate; you can select a rate from 2 Hertz to 32768 Hertz 
by increasing powers of two. This provides for time periods 
ranging from 30.517 microseconds to 500 milliseconds. 
Register B is the interrupt and flag enable byte. Use this byte 
to enable the internal flags and generate an external interrupt. 
Register C is the status register. Read this register to see what 
has caused an alarm to occur. 

To access the 146818 you must first write the 146818 ad¬ 
dress to port 70H. A latch in the computer will hold the ad¬ 
dress byte. Then you can either read or write the desired chip 
location by accessing location 71H (see read__146818() and 
write_146818() in Listing 2). 

In your initialization, first save the old 70H interrupt inter¬ 
rupt vector and install the vector to the new interrupt routine. 


Listing 2 


#include "dos.h" 
linclude “conio.h" 


/**** save previous internal values 
unsigned char old_8259; 

unsigned char old_146818_a; 

unsigned char old 146818 b; 

**** j 

/**** our interrupt routine 
void interrupt timer_check( void); 

*★** i 

/**** old 0x70 interrupt 

void interrupt (*old_int_70)( void); 

**** j 

/**** interrupt setup routine 
void setup_periodic_interrupt( void); 

★★★★ j 

/**** interrupt stop routine 

void clear_periodic_interrupt( void); 

**** j 

/***» write a byte to 146818 
void write_146818( unsigned char port, 
unsigned char data); 

**** j 

/**** read a byte from 146818 chip ****/ 

unsigned char read_146818( unsigned char port); 

/*♦** interrupt occurred flag 
int time_out « 0; 

*★** j 
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Inside the 146818 


The MCI46818 Real-Time Clock Plus Ram has 64 internal ad¬ 
dresses. The first fourteen are used for clock programming 
and operations: the other 50 are used as non-volatiie bat¬ 
tery-backed RAM. 


Location 

Function 

0 

Time of day seconds count 

i 

Alarm time seconds value 

2 

Time of day minutes count 

3 

Alarm time minutes value 

4 

Time of day hours count 

5 

Alarm time hours value 

6 

Day of week (Sunday = 1) 

7 

Date of month 

8 

Month 

9 

Year 

A-D 

Status registers 


Register A 

This register is used to program the divider chain. The 
time base frequency is used to configure the chip for dif¬ 
ferent external clock frequencies. The rate selection bits are 
used to set the periodic interrupt frequency and square 
wave frequency. 


Register B 

This register is a control register. The bits enable the ex¬ 
ternal interrupts or configure internal operation or the chip. 


Bit 

Function 

7 

Set —when 1, the internal time update is not 
done, so the time and date can be set 

6 

Periodic interrupt enable —set to 1 for interrupts 

5 

Alarm interrupt enable —set to 1 for alarm 
interrupt; chip generates an interrupt when the 
clock time is the same as the values in the alarm 
register 

4 

Update-ended interrupt enable —set to 1 for 
interrupt; chip generates an interrupt after the 
internal time registers are updated 

3 

Square wave enable — when 1, a square wave is 
generated at the SQW pin (pin 23) 

2 

Data mode bit — when 1, the data is binary; when 

0, the internal data is binary-coded-decimal 

1 

24/12 bit —when 1, the internal clock will be 24 
hours; when 0, the clock will be 12 hours 

0 

Daylight Savings enable —when 1, the clock will 
change on the last Sunday in April and the last 
Sunday in October to adjust for Daylight Savings 

Time 


Bit 

Function 

7 





Update in Progress (UIP) —if 1 a 






time update is occuring 

6-4 





Time base frequency —set for 






32kHz; do not change 

3-0 

Rate Selection Bits: 



Bits 


Periodic Interrupt 


3 

2 

1 

0 




0 

0 

0 

0 

None 



0 

0 

0 

1 

3.90625 

milliseconds 


0 

0 

1 

0 

7.8125 

milliseconds 


0 

0 

1 

1 

122.070 

microseconds 


0 

1 

0 

0 

244.141 

microseconds 


0 

1 

0 

1 

488.281 

microseconds 


0 

1 

1 

0 

976.562 

microseconds 


0 

1 

1 

1 

1.953125 

milliseconds 


1 

0 

0 

0 

3.90625 

milliseconds 


1 

0 

0 

1 

7.8125 

milliseconds 


1 

0 

1 

0 

15.625 

milliseconds 


1 

0 

1 

1 

31.225 

milliseconds 


1 

1 

0 

0 

62.5 

milliseconds 


1 

1 

0 

1 

125.0 

milliseconds 


1 

1 

1 

0 

250.0 

milliseconds 


1 

1 

1 

1 

500.0 

milliseconds 


Register C 

This register is a status register. Read the register to 
check the current state of the interrupt flags. The flags will 
be reset to zeros when the register is read or the chip is 
reset. 


Bit 

Function 

7 

Interrupt request flag —set to 1 when an external 
interrupt should be changed 

6 

Periodic interrupt flag —set to 1 when a periodic 
interrupt has occurred 

5 

Alarm interrupt flag —set to 1 when the current 
time matches the alarm time 

4 

Update-ended flag —set to 1 after each time update 

3-0 

Not used —will be zeros 


Register D 

This register holds the valid RAM and time bit. 


Bit 

Function 

7 

VRT -this bit will be 0 when the power is 
removed from the chip; it should be set to 1 after 
the time and date are set 
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Then program the interrupt rate into register A, bits 0-3 and 
set the periodic interrupt enable bit (bit 6) in register B. When 
the periodic interrupt occurs, the hardware will generate a call 
to interrupt vector 70H. You must next program the 8259A 


Listing 2 — Cont’d 


void main( void) 

{/* test program to check out clock chip */ 


/* periodic interrupt */ 

/**** setup for periodic interrupt ***»/ 

setup_periodic_interrupt(); 

/**** clear the screen ***»/ 

clrscr(); 

/**** until a keypress happens »***/ 

while ( !kbhit()) 

{ 

/**** timer interrupt ? ***■»/ 


if ( time_out) 

( 

time_out = 0; 
putch('T'); 

} 

} 

/**** stop periodic interrupt ***»/ 

clear_periodic_interrupt(); 


void setup_periodic_interrupt( void) 

{/* do the housekeeping to start interrupt */ 


/*»** change interrupt vector ****/ 

old_int_70 ■ getvect( 0x70); 
setvect( 0x70, timer_check); 

/**** read timer register ****/ 

old_146818_a = read_146818( Oxa); 

/**** set to 2 hz rate ****/ 

write_146818( Oxa, old_146818_a | Oxf); 

/**** enable periodic timer ***»/ 

old_146818_b = read_146818( Oxb); 
write_146818( Oxb, old_146818_b j 0x40); 

/**** read interrupt mask ****/ 

old_8259 * inportb( Oxal); 

/**** enable INT 0 ****/ 

outportb( Oxal, old_8259 & Oxfe ); 

/**** clear PF flag ****/ 

read_146818( Oxc); 

} 


void clear_periodic_interrupt( void) 

{/* do the housekeeping to stop interrupt */ 


DOS & WINDOWS SERIAL 
COMMUNICATIONS DONE THE 
RIGHT WAY 

COMM-DRV is a professional serial communication 
library & device driver for DOS & Windows. 

• Desqview, Procomm DOS/Windows, pcAnywhere 
compatible. 

• Support for most smart & Dumb Multiport cards. 

• Link libraries into application or use external TSR. 

• C, Assembly, Quickbasic, Windows SDK support. 

• Full source for X&Ymodem file Xfer, serial com¬ 
munication libraries, & screen/keyboard libraries. 

• Remote screen management with remote ANSI 
emulation (window scrolling, erasing, etc.). 
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Bauds up to 115.2K. 

• Real-Time serial port monitor. 

9 16550A, 16450, 8250 auto detection. 
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Develop Serial Communication 
Applications In English 

COMM-LOG is a collection of programs & TSRs for 
developing custom applications through our simple 
english like full featured script language. 

• True background X&Ymodem file transfers on 
several ports concurrently. 

• Run several scripts concurrently in the background, 
foreground, or from application. 

• Built in script language debugging support. 

• Complete data logging support. 

TSRs and multiple examples $189.95 

MS-DOS Multitasking Kernel 

MTASK is a robust multitasking kernel for develop¬ 
ing cooperating multitasking TSRs and programs 
with several threads of execution. Full task control, 
including mailboxes, TSR building routines, IPCs, 
task blocking, sleeping, RTC control, much more!!! 


TSRs, Libraries, & Examples $89.95 

_Multiport Cards_ 

Four Port Multiport card w/16450 $110.00 

Four Port Multiport card w/16550A $170.00 

Eight Port Multiport card w/16550A $225.00 
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interrupt controller to allow interrupts from the 146818. To do 
this, read the current 8259 enable byte and clear bit 0; then 
write the byte back to the 8259 chip (see setup_peri- 
odic_interrupt() in Listing 1). 

In the interrupt handler, check the periodic interrupt bit (bit 
6) in register C. If this bit is set, a periodic interrupt has oc¬ 
curred and you can execute your interrupt code; otherwise, 
either an alarm or time update interrupt has occurred. One 
problem with this method is that the status bit is cleared 
when you read register C. As a consequence, if the BIOS func¬ 
tions are using the real-time clock, the status bit will be reset 
and the BIOS may not operate correctly. 

When the program is terminated, the clock chip, interrupt 
controller, and interrupt vectors must be restored. First, write 
the old A and B registers back to the 146818; second, restore 
the 8259 interrupt enable byte-, and finally, restore the old 70h 
interrrupt vector (see clear_periodic_interrupt() in Listing 
2 ). 

I've described two methods for implementing a time base 
on the AT-type computer; which you should use depends on 
the nature of your application. In a cooperative multitasking 
system, the first method would work best because it is easy 
to use and requires very little overhead. But if you want a 
full-blown preemptive multitasking system, then you will 
need to use the second method. □ 
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Listing 2 — Cont’d 


/***** disable periodic tinier 

**** j 

write 146818( Oxa, old 146818 a); 


write_146818( Oxb, old_146818_b) ; 


/***» fix 8259 C hip 

***★ j 

outportb( Oxal, old_8259); 


/»*** fi x interrupt vector 

**** J 

setvect( 0x70, old int 70); 

} 


void interrupt timer_check( void) 


{/* timer interrupt handler 

*/ 

/**** read the timer C register 

**** j 

outportb( 0x70, Oxc); 


time out = inportb( 0x071); 


enableO; 


/**** write E0I to 8259 

kkkk j 

outportb( OxaO, 0x20); 


outportb( 0 x 20 , 0 x 20 ); 


/***** mask periodic interrupt 

**** J 

time out &= 0x40; 


/***** call old interrupt, if needed 

**** j 

if ( !time out) 


(*old int 70) (); 

) 


void write 146818( unsigned char port, 


unsigned char data) 


{/* write a byte to the real-time chip 

*1 

/**»* no interrupts during this 

■kirk * j 

disableO ; 


/**** send the address to latch 

**** j 

outportb( 0x70, port); 


/**** write the data 

•kkkk J 

outportb( 0x71, data); 


enableO ; 

) 


unsigned char read_146818( unsigned char 

port) 

{/* read a byte from the real-time chip 

*/ 

/**** temp for input storage 

**** j 

char data; 


/*»** no interrupts during this 

irk irk J 

disableO; 


/***» sen( j the address to latch 

kkkk j 

outportb( 0x70, port); 


/**** read the data 

★★★★ j 

data * inportb( 0x71); 


enableO ; 
return data; 

) 

/* End of File */ 



September 1992 

























The Win32 Professional 
Developers’ Conference 

Ron Burk 


The Microsoft Win32 Professional Developers’ Conference was a jammed, highly 
technical, three-day marketing tour-de-force for Windows NT and the Win32 API. 
Attendance estimates ranged as high as 4,600 developers, and the crowd filled two 
cavernous auditoriums at San Francisco's Moscone Center. Things went remarkably 
smoothly, considering the scale of the show and how quickly it was put together 
(the core developers were trying to meet their deadlines for building the pre-release 
version of windows NT at the same time as they prepared their technical presenta¬ 
tions). 

Windows Q6cA columnist Paul Bonneau and I got off to a rocky start as Microsoft 
registered us under the title “Windows DOS Developers.” It could have been worse, 
though, as the folks at WUGNET (Windows Users Group NETwork) were identified in 
the vendor guide as “WUGNUT,” in all caps and boldface, no less. There was no 
particular conspiracy against non-Microsoft publications, however, as M&T Publishing 
(marketers of the Microsoft-controlled Microsoft Systems Journal) got labeled as 
"MNT." 


Ron Burk has a B.S.E.E. from the University of Kansas and has been a programmer for 
the past 10 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. 
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After the obligatory introduction by Bill Gates and a live 
demonstration of Windows NT by Paul Maritz (who showed a 
surprising level of technical competence during the question 
and answer session), the real fun began. Lou Perazzoli, one of 
the head developers, launched into a technical overview. Any 
mainstream press people still in the audience were left in the 
dust, as the topics turned to client/server architecture, object- 
based security, memory-mapped file I/O, and a great many 
other technical topics. After the first day of such presentations, 
the consensus among attendees was that Microsoft had suc¬ 
cessfully responded to complaints that previous developers' 
conferences had contained too much marketing and not 
enough technical information. 

The mornings and early afternoons were consumed by the 
big presentations, including Dave Cutler's tour of the NT ker¬ 
nel. The rest of each day included breakout sessions on more 
detailed topics. Microsoft responded to suggestions throughout 
the conference, and, as a result, many of the core developers 
were available in the hands-on demonstration room for large 
blocks of time to answer one-on-one questions, in the hands- 
on room you could play with Windows NT on standard PCs, 
MIPS RISC workstations, and even a multiprocessor NCR 
machine. 


M 
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The vendor room contained around 100 vendor booths, 
some of them already sporting NT products. Developers will 
not be confined to Microsoft development tools. MicroEdge 
presented their SlickEdit for Windows NT, which they have 
had running since May, 1991. I fought my way to one 
crowded booth to discover that the main attraction was CD- 
ROM drives (Microsoft distributes the Preliminary Software 
Development Kit [PDK] only on CD-ROM). Checking my Compu¬ 
Serve mail, I even saw what claimed to be the first shareware 
program for Windows NT in the MSWIN32 forum. 

The PDK 

Attendees received a CD-ROM containing the Preliminary 
Software Development Kit (PDK). Anyone can purchase the 
same package for $69 by calling Microsoft at (800) 227-4679 
or, from Canada, (800) 563-9048. If you live outside the US or 
Canada, you are supposed to contact your local Microsoft rep¬ 
resentative. Unfortunately, the roughly 8,000 pages of 
documentation on the CD-ROM are in PostScript format, which 
most developers will not be able to view online. A copy of the 
PDK with printed documentation costs $399, roughly what it 
would cost you to print 8,000 pages on your laser printer 
anyway. 

It is a good thing that the PDK is cheap, because the 
hardware you need to use it is not. Since the PDK comes only 
on CD-ROM, you may have to add a CD drive to your system. 
If you use the crude copying version of the installation, then 
most any CD will do. If you want to use the fancy, graphical 
version of the install program, you need to check with 
Microsoft for the list of supported CD drives. For example, the 
CD-ROM drive that comes with the popular (and cheap) Sound 
Blaster CD/audio bundle is apparently not supported yet. 

Besides a CD-ROM drive, you need at least an 80386 
processor to run Windows NT. Steppings B0 and B1 of the chip 
have bugs that make them unacceptable. The MSWIN32 forum 
on CompuServe contains isbste.zip, a program that tells you 
if your 80386 is one of the unlucky ones. After getting the 
right processor, you need memory - lots. Just to run the pre¬ 
release windows NT requires 8Mb and development requires 
12Mb, but Microsoft recommends 16Mb. Microsoft also recom¬ 
mends at least 100Mb of disk space to install the operating 
system and all the development tools. 

Most of the tools in the PDK are 32-bit Windows NT ver¬ 
sions of the Windows 3.1 SDK tools. One important addition is 
a program that scans your Windows 3.1 code and locates 
changes you may have to make in order to port your code to 
the Win32 API. The package also includes a debugger that 
uses the new Win32 debugging interface and profiling tools 
for tuning application performance. 

Future versions of the PDK will contain Win32s, which con¬ 
sists of a loader, a VxD, and a set of DLLs-, together they supp¬ 
ly a subset of the Win32 API under Windows 3.1. You can 
distribute these components with your application just as 
Windows 3.1 applications currently distribute libraries such as 
the common dialog DLL. Win32s is of prime importance, since 
the hardware requirements of Windows NT will probably keep 
it from dominating Windows sales for at least a year or two. 
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Phar Lap Freebies 

One of the more interesting vendor strategies was Phar 
Lap's coupons for a free copy of their new QuickStart for Win¬ 
dows NT. Attendees just filled out a short questionnaire and 
Phar Lap shipped the product to them a couple of weeks 
later. QuickStart operates on the development tools Microsoft 
supplies with the PDK (32-bit C/C++ compiler, linker, and 
resource compiler) to create versions of these tools you can 
run under DOS. So, if your favorite development tools haven’t 
been ported to Windows NT yet, you can use QuickStart to 
move the NT tools back to DOS. You can then compile and 
edit in DOS, although you will have to run the executable 
under Windows NT. 

Obviously, this product has a limited life expectancy (didn’t 
we say that about the original Phar Lap DOS extender?), and at 
$.00, Phar Lap has to lose money on every copy they ship. On 
the other hand, the company gets the names and addresses 
of Windows NT developers and they succeed in demonstrating 
their commitment to the Windows NT market. If you think 
about what Phar Lap had to know about Windows NT to cre¬ 
ate this product, it makes it seem likely that we will be seeing 
some future Phar Lap products for Windows NT developers. 

QuickStart may not be free anymore by the time you read 
this. Contact Phar Lap at (617) 661-1510 to get the latest infor¬ 
mation. 

Non-Microsoft Compilers 

Borland has been conspicuously subdued on the subject of 
Windows NT, but not at all shy about touting their upcoming 
OS/2 development tools. Therefore, it was with great interest 
that I attended the Borland announcement at the conference, 
where Borland VP Eugene Wang gave a highly entertaining, if 
not totally convincing, speech about ground-breaking levels of 
cooperation between Borland and Microsoft. 

The big news is that Microsoft has been working with Bor¬ 
land and other compiler vendors to make sure that they can 
deliver tools for both Windows NT and Win32s. You can ex¬ 
pect to see Watcom, Symantec (Zortech), Borland, and DEC all 
ship 32-bit C/C++ compilers for Win32s and Windows NT. 
Microsoft is licensing the necessary libraries and documenta¬ 
tion to these vendors. This is clearly at the expense of 
Microsoft’s beleaguered Languages group, but all for the good 
of the success of Windows NT and Win32s developers. 

SEF 

The Software Entrepreneur’s Foundation (SEF) is a popular 
Silicon Valley programmer's group, originally founded by Alan 
Cooper. The Windows SIG (run by Fran Finnegan) of the SEF 
was sponsoring a meeting at a nearby hotel. SEF waived their 
normal admission fee for nonmembers and, since the featured 
speaker was Andrew Schulman presenting his new book Un¬ 
documented Windows, Alan convinced us it was our duty to 
attend. SEF meetings tend to have interesting and well-known 
speakers, well worth attending if you are in the Silicon Valley 
area. 

I entered unconvinced that there was enough undocu¬ 
mented functionality in Windows to be of interest, but I left a 
believer. The first ten minutes of Andrew's presentation was 
basically an apology for pandering to programmers’ cruder 


desires to know things they should not take advantage of. 
The rest of the presentation, however, took a look at some of 
the tools that come with the book and some of the informa¬ 
tion that the book's authors have uncovered with those tools. 
It was the right presentation for the right audience, which in¬ 
cluded Jeffrey Richter, Charles Petzold, and other Windows 
luminaries; I have never seen a room full of people chortle 
over screenfuls of such obscure information. 

Summary 

The most important OS/2 mistake that Microsoft is refusing 
to repeat for Windows NT is ignoring the importance of 
developers. Applications drive operating systems sales, and 
the operating system with the preponderance of loyal 
developers will win the war. The fact that developers can ob¬ 
tain the preliminary and final versions of the NT SDK for 
around $100 rather than $1,000 or $2,000 will have a crucial 
impact on the number of developers who decide to create 
Win32 applications. 

The operating systems war has all the trappings of a 
presidential campaign - substance and reason do not always 
triumph over slippery marketing and rhetoric. However, com¬ 
ing out of the Win32 Professional Developers’ Conference, 
Windows NT has acquired the prized but elusive quality of 
“momentum", the rest is up to developers. □ 
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Excel-Style 


Paul Bonneau 



New user interface functionality from Microsoft usually makes its debut in 
Excel. For this reason Excel sets something of a de facto standard for profes¬ 
sional application writers who want to implement the same level of polish. In 
particular, Excel, a multiple document interface (MDI) application, implements a 
level of intradialog keyboard navigation not provided by the Windows MDI 
manager. Excel allows the user to display the system menu of a modeless 
dialog (and, incidentally, to activate the dialog window) via the keyboard — 
functionality that is unavailable to a standard MDI application. This article 
focuses on how to provide similar functionality within an application that uses 
the Windows MDI manager, but the techniques it describes will also be of inter¬ 
est if you need to know how hook procedures can alter default window be¬ 
havior. 

The Excel Style 

A standard MDI (Multiple Document Interface) application lets you arrow 
through the application's system menu, frame window menu items, and the 
active child MDI window's system menu. For example, if you are inside Borland’s 
TPW and you press the Alt key, TPW highlights (selects) the system menu of 
the child MDI window you are editing in. If you press the right arrow key, TPW 
highlights the first entry in the frame window's menu (File). As you keep 
pressing the right arrow key, it moves along the menu bar. If you press the 
right arrow key when the rightmost frame window menu-bar item is selected, 
TPW then highlights the main system menu. One more press of the right arrow 
key returns the highlight to the system menu of your original MDI child win¬ 
dow. A left arrow key moves the menu highlight in the reverse sequence. 

The behavior is slightly different if you actually pull a menu down. For ex¬ 
ample, if you press the Alt key and then a down arrow key, TPW displays the 
system menu for your current MDI child window. Now, each time you press a 
right arrow key, TPW moves the highlight as before, but also drops the cor¬ 
responding menu, making it easy to quickly view all the top-level menus. 

If you maximize the MDI child window, parts of the MDI menu bar get incor¬ 
porated into the frame window's menu bar, specifically the system menu icon 
and the double-headed arrow icon (for restoring the MDI child to its previous 
size). Now, the double-headed arrow icon is considered to be the last menu 
item in the frame window's menu bar. 

Excel adds another feature to this keyboard navigation scheme: it includes 
any modeless dialogs in the list of menus. For example, if you invoke Excel and 
then select the Table option from the Data menu, a modeless dialog appears. If 
you then press the A11 key, Excel highlights the system menu for the modeless 
dialog. If you then press a right arrow key, the highlight moves to the system 
menu of the current child MDI window. Additional right arrows behave 
as with a standard MDI application except that, after the application sys¬ 
tem menu, the highlight moves back to the system menu of the original 
modeless dialog. 

There are a couple of additional wrinkles to the Excel scheme. If 
navigation is occurring with no menu popped up (for example, if you just 
pressed the Alt key without a down arrow key), a menu will pop up 
whenever navigation crosses a dialog boundary. Also, if an MDI child is 
maximized, navigation with the left arrow will not include any modeless 
dialogs! Whether these are intentional features is hard to say; they seem 


Paul Bonneau is the Windows questions and answers columnist for the 
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Menu Navigation 


inconsistent with the standard MDI model. I am not going to debate the aes¬ 
thetics of Excel's menu navigation scheme, however; my goal here is to try to 
reproduce it 

The Solution 

Windows 3.x does not supply the Excel style of menu navigation, but a 
solution can still be had by making use of my old friend, the message filter 
hook. From volume 2 of the Programmer's Reference-. “The MessageProc func¬ 
tion is an application- or library-defined callback function that the system calls 
after a dialog box, message box, or menu has retrieved a message, but before 
the message is processed. The callback function can process or modify the 
messages.” When in a modal dialog or menu mode, your application is execut¬ 
ing from a message pump inside Windows, but the message filter hook gives 
some control back to your application. 

My approach to this problem is to coexist with the MDI menu management, 
but to take control when a system menu item has to be activated or deac¬ 
tivated or when a system menu has to be popped up or removed from a 
modeless dialog. 

Given Excel's navigation path, the menu "crossings” of importance to the 
hook procedure are from the frame window's system menu item to the active 
MDI child window’s system menu item. If there is no MDI child window, then 
the important crossing is from the frame window's system menu item to the 
first non-system menu item. Of course, if there are no modeless dialogs present, 
then the hook procedure need not bother looking at any crossings (or mes¬ 
sages for that matter). You can use the HM_KEYDOUN message with wParam equal 
to VK_LEFT or VK_RIGHT as the message of potential importance. Exactly one of 
these messages will be received by the hook each time the user presses the 
left or right arrow. 

Once an important crossing occurs, you need to force the application to exit 
menu mode so that the appropriate window can be activated and menu mode 
re-entered on this new window. Since Windows passes the hook procedure a 
pointer to the message structure (via IParam), the hook procedure can modify 
the message. In this case, changing wParam to VK_ESCAPE (from VK_RIGHT or 
VK_LEFT) will trick the menu manager into thinking the user is dismissing the 
menu by pressing the Escape key. If a menu was dropped, two Escapes are 
required, the first to remove the menu and the second to de-highlight the 
active menu item and exit menu mode, so the hook procedure should post an 
extra WM_KEYDOUN with a wParam of VK_ESCAPE-, if no menu was dropped, the 
extra Escape is benign. 

After your hook procedure exits menu mode, you will have to activate the 
new menu. Before a menu item can be activated, the window containing the 
menu item must be active. But if you call SetFocusf) (or SetActiveUindowf)) 
from within the hook procedure when in menu mode, the menu manager will 
become confused and the result will be two active menu items. It is necessary 
to perform the SetFocusf) outside of message mode. You could have the hook 
procedure set a global flag that the main window procedure polls, but it is 
easier to just encode a new message constant and post the message from the 
hook procedure to the main window procedure. You need to post this new 
message (call it wmNextMenu) after the VK_ESCAPE is posted, so that by the time 
the main window procedure receives the wmNextMenu, the application will be 
out of menu mode. You can use the wParam field to hold the window to ac¬ 
tivate, and it is also helpful to encode whether the arrow pressed was the left 
or right arrow by using IParam as a Boolean. 
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propriate menu item, and, since you are emulating Excel, drop 
the associated popup menu. Implementing the code to drop 
the menu turns out to be non-obvious. After several ex¬ 
asperating hours of posting various combinations of keyboard 
messages to the window, I finally used the debugger to see 
just what sequence of events was being pulled from the 
queue to properly activate a menu item and drop its popup. 

It turns out that, first of all, your application needs to re¬ 
enter menu mode. This can be accomplished by posting a 
UM_SYSKEYDOUN/WM_SYSKEYUP pair (UM_KEYDOWN and WM_KEYUP 
won’t work) for the Alt key, VK_MENU. Also, you have to get 
the right IParam values. The IParam for keyboard messages is 
a bit field that encodes additional keyboard state information, 
as shown in Figure 1. The most significant bit (bit 31) indicates 
the key transition; for a key-down message it should be 0, 
and for a key-up it should be 1. The next bit (30) specifies the 
previous key state; since you only want to simulate a single 
When the main window procedure receives wmNextMenu, it short keystroke of the Alt key (you don't want to simulate 

can set the focus to the new window, activate the ap- typeamatic mode), bit 30 should be 0 for the key-down message 


Figure 1 


repeat count 


fO = Alt key is down 
[1 = Alt key i* up 

[ 0 : key was up 
1 = key was down 

[ 0 = key is being depressed 
1 1 key is being released 


Format of Iparam for Keystroke Messages 


Listing 1 (mdimenu.c) 

!*******★****★*★★★★★*★***★********★**★***★★****★★**★★★ i 

LPARAM); 

/* — Demonstration of how to achieve MDI-like menu */ 

LRESULT CALLBACK MDIChi1dWndProc(HWND, UINT, WPARAM, 

/* navigation using left and right arrows to */ 

LPARAM); 

/* include modeless dialog boxes. */ 

BOOL FInit(BOOL, int); 

/★★★A************************************************* i 

HWND MakeNewChi 1 d(VOID); 

linclude <stdio.h> /* for sprintf */ 

LRESULT CALLBACK MenuHookProc(int, WPARAM, LPARAM); 

linclude <windows.h> 

LRESULT CALLBACK ModelessDlgProc(HWND, UINT, WPARAM, 

linclude “mdimenu.h" 

LPARAM); 


VOID NextMenu(HWND, BOOL); 

/* Tell main window to drop next menu. */ 

Idefine wmNextMenu WM USER 

int PASCAL 


WinMain(HINSTANCE hinsThis, HINSTANCE hinsPrev, 

/* Menu item "indices". */ 

LPSTR IpszCmdLine, int wShow) 

Idefine imnuMDI -2 /* MDI child system menu. */ 

/***************************************************** j 

Idefine imnuFrame -1 /* Frame's system menu. */ 

/* — Entry point. *1 

Idefine imnuFirst 0 /* First frame menu item. */ 

Idefine imnuOther 1 /* None of the above. */ 

^*****************************************************y 

{ 


MSG msg; 

/* Frame window class name. */ 

Idefine szFrame "frame" 

hins = hinsThis; 

/* MDI child window class name. */ 

if (!FInit(hinsPrev == NULL, wShow)) 

Idefine szChild "child" 

return 0; 

/* Linked window list tags. */ 

/* Enter main message loop. */ 

Idefine szPropNext "Next window" 

while (GetMessage(&msg, NULL, 0, 0)) 

Idefine szPropPrev "Previous window" 

{ 

if (TranslateMDISysAccel(hwndMDl, &msg)) 

/* Key constants for faking presses. */ 

Idefine lfSysUp 0xc0380001 

continue; 


/* Is this message for a dialog? */ 

HHOOK hhook; 

if (hwndDlg != NULL && 

HINSTANCE hins; /* App. instance handle. */ 

IsDialogMessage(hwndDlg, &msg)) 

HWND hwndMain; /* Main window. */ 

HWND hwndMDl; /* MDI client window. */ 

continue; 

HWND hwndMDIActive; /* Active MDI window. */ 

TranslateMessage(&msg); 

HWND hwndDlg; /* Active dialog window. */ 

BOOL flgnoreMessage; /* Disable hook. */ 

DispatchMessage(&msg); 

I 

HMENU hmnuFirst; /* First popup menu. */ 

int iwndMdi; /* MDI child number. */ 

if (lpfnModeless != NULL) 


FreeProcInstance((FARPROC)lpfnModeless); 

/* Currently dropped menu. */ 

if (hhook l- NULL) 

int imnu * imnuFrame; 

UnhookWindowsHook(WH MSGFILTER, 1pfnMenuHook); 
if (1pfnMenuHook != NULL) 

HOOKPROC 1pfnMenuHook; /* Hook proc. */ 

FreeProcInstance((FARPROC)1pfnMenuHook); 

DLGPROC lpfnModeless; /* Dialog proc. */ 

return 0; 

LRESULT CALLBACK FrameWndProc(HWND, UINT, WPARAM, 

) 

Demonstration of Excel-Style Menu Navigation 
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Listing 1 

— Cont’d 

BOOL 

"Custom MDI Menus", 

FInit(BOOL fFirst, int wShow) 

WS OVERLAPPEDWINDOW | WS CLIPCHILDREN, 

/*****************************************************i 

CW USEDEFAULT, 0, CW USE0EFAULT, 0. NULL, NULL, 

/* — Register classes if first instance. */ 

bins, NULL)) == NULLj 

!*****************************************************i 

return FALSE; 

{ 

if (fFirst) 

if (hwndMDI “ NULL) 

( 

return FALSE; 

WNDCLASS wc; 

/* Register the frame class. */ 

/* Display the frame window. */ 

ShowWindow(hwndMain, wShow); 

wc.style * 0; 

UpdateWindow(hwndMain); 

wc.lpfnWndProc * FrameWndProc; 
wc.cbClsExtra = 0; 

/* Make the first MDI child window. */ 

wc.cbWndExtra * 0; 

MakeNewChild(); 

wc.hlnstance * hi ns; 
wc.hlcon - NULL; 

/* Get some procedure instance handles for */ 

wc.hCursor = LoadCursor(NULL, IDC ARROW); 

/* dialog and hook procs. */ 

wc.hbrBackground = 

if ((lpfnModeless = (DLGPROC)MakeProcInstance( 

(HBRUSH)(COLOR APPWORKSPACE + 1); 

(FARPROC)ModelessDlgProc, hins)) E = NULL) 

wc.lpszMenuName = "MdiHenu"; 

return FALSE; 

wc.lpszClassName = szFrame; 
if (!RegisterClass(&wc)) 

if ((1pfnMenuHook = (H00KPR0C)MakeProcInstance( 

return FALSE; 

(FARPROC)MenuHookProc, hins)) == NULL) 

/* Register the MDI child class. */ 
wc.lpfnWndProc = MDIChildWndProc; 

return FALSE; 

/* Install the hook proc. */ 

wc.hlcon = NULL; 

if ((hhook = SetWindowsHook(WH MSGFILTER, 

wc.lpszMenuName = NULL; 

1pfnMenuHook)) == NULL) 

wc.cbWndExtra = 0; 

return FALSE; 

wc.lpszClassName = szChild; 
if (!RegisterClass(&wc)) 

return TRUE; 

return FALSE; 
i 

i 

/* Create the frame. The MDI Client window is */ 

LRESULT CALLBACK 

FrameWndProc(HWN0 hwnd, UINT wm, WPARAM wParam, 

/* created in the frame's WM CREATE case. */ 

LPARAM IParam) 

if ((hwndMain * CreateWindowXszFrame, 
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and 1 for the key-up message. Bit 29 indicates whether the 
Alt key was down during the transition; since you are 
simulating a press of the Alt key, this bit had better be 1. The 
least significant 16 bits encode the repeat count. The entire 
field should be set to 1 since you are simulating a single 
keystroke. The remaining 13 bits (bits 16-28 inclusive) can be 
left 0. So, for the WM_SYSKEYDOWN, an IParam of 0x20000001 is 
required, and for WM_SYSKEYUP, IParam should be OxcOOOOOOl. 


Once the above messages have been received, a menu 
item will be activated. If the window contains a menu bar, the 
first menu item in the menu bar will be activated. Otherwise, 
the system menu item will be activated. Depending on the 
state of the system before the user pressed the arrow key, 
and on which arrow key was pressed, one of three menus 
should be displayed. 


Listing 1 

— Cont’d 

/★**★★*★***★*★★*★***★★*★***★****★★*★**★★**★***★★**★**★j 

DestroyWindow(hwnd); 

/* -- Frame window proc. */ 

/★★★★★★★★★★★★★★★★★★■ft********************************** j 

{ 

return 0; 

case WM DESTROY: 

switch (wm) 

RemoveProp(hwnd, szPropNext); 

I 

RemoveProp(hwnd, szPropPrev); 

default: 

PostQuitMessage(O); 

break; 

return 0; 

/* Next two cases track the last menuitem */ 

case wmNextMenu: 

/* activated. *t 

/* This is where we do all the work. */ 

case WM MENUSELECT: 

NextMenu((HWND)wParam, (B00L)1Param); 

if (L0W0RD(IParam) & MF SVSMENU) 

return 0; 

imnu = imnuFrame; 

else if (hmnuFirst “ (HMENU)wParam) 

) 

imnu * imnuFirst; 

return 

else 

DefFrameProc(hwnd, hwndMDI, wm, wParam, IParam); 

imnu = imnuOther; 
break; 

) 

LRESULT CALLBACK 

case WM CREATE: 

MDIChi1dWndProc(HWND hwnd, UINT wm. 

( 

WPARAM wParam, LPARAM IParam) 

CLIENTCREATESTRUCT CCS; 

/*****************************************************j 

HMENU hmnuMain; 

/* — MDI child window proc. */ 

^***************************************************** J 

/* Get first submenu handle. */ 

{ 

hmnuMain = GetMenu(hwnd); 

switch (wm) 

hmnuFirst = GetSubMenu(hmnuMain, 0); 

( 

default: 

/* Window menu to list children. */ 
ccs.hWindowMenu = 

break; 

GetSubMenu(hmnuMain, cmnu - 1); 

/* Keep track of active MDI window. */ 

ccs.idFirstChild = idmModeless + 1; 

case WM_MDIACTIVATE: 

hwndMDIActive = wParam ? hwnd : NULL; 

/* Create the MOI client. */ 

hwndMDI = CreateWindow("mdiclient", NULL, 

break; 

WS CHILD I WS CLIPCHILDREN, 0, 0, 0, 0, hwnd. 

/* Keep track of active menuitem. */ 

0, hins, (LPSTR)iccs); 

case WM MENUSELECT: 

ShowWindow(hwndMDI, SW_SH0W); 

imnu = imnuMDI; 
break; 

/* Initialize doubly linked window list. */ 

SetProp(hwnd, szPropNext, (HANDLE)hwnd); 

} 

SetProp(hwnd, szPropPrev, (HANDLE)hwnd); 

) 

return 0; 

return DefMDIChildProc(hwnd, wm, wParam, IParam); 

) 

LRESULT CALLBACK 

case WM COMMAND: 

ModelessDlgProc(HWND hwnd, UINT wm, WPARAM wParam, 

switch (wParam) 

LPARAM IParam) 

( 

/★*********★★****★**★★★*★★*****★*★****★★*★**★****★***★ j 

default: 

/* .. Modeless dialog proc. */ 

break; 

j ***************************************************** j 

case idmNew: 

{ 

switch (wm) 

/* Make an empty MDI child window. */ 

f 

MakeNewChi1d(); 

default: 

return 0; 

break; 

case idmModeless: 

case WM INITDIAL0G: 

CreateDialog(hins, "MdiDialog”, hwndMain, 

( 

lpfnModeless); 
return 0; 

HWND hwndPrev; 

1 

/* Insert into doubly linked list. */ 

break; 

hwndPrev = (HWND)GetProp(hwndMain, szPropPrev); 
SetProp(hwnd, szPropNext, (HANDLE)hwndMain); 

case WM_CL0SE: 

SetPropjhwnd, szPropPrev, (HANDLE)hwndPrev); 
SetProp(hwndPrev, szPropNext, (HANOLE)hwnd); 
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Cose 1: If the window containing the menu to display has 
only a system menu, or if the user pressed the left arrow 
when a modeless dialog had the active menu item, then the 
system menu should be displayed. 


Case 2: If the window containing the active menu item is a 
modeless dialog, there are no MDI children present, the win¬ 
dow containing the menu to display has a menu bar, and the 


Listing 1 

SetProp(hwndMain, szPropPrev, (HANDLE)hwnd); 

) 

break; 

case WM_ACTIVATE: 

hwndDlg * wParam ? hwnd : NULL; 
break; 

case WM_CL0SE: 

DestroyWindow(hwnd); 
return TRUE; 

case WM_DESTROY: 

( 

HWND hwndNext, hwndPrev; 

/* Unlink. */ 

hwndNext 1 (HWND)GetProp(hwnd, szPropNext); 
hwndPrev * (HWND)GetProp(hwnd, szPropPrev); 
SetPropfhwndPrev, szPropNext, 

(HANDLE)hwndNext); 

SetProp(hwndNext, szPropPrev, 

(HANDLE)hwndPrev); 

RemoveProp(hwnd, szPropNext); 

RemoveProp(hwnd, szPropPrev); 

) 

break; 

) 

return FALSE; 


HWND 

MakeNewChild(VOID) 

/***************************************************** j 

/* -- Creates a new MDI child window. */ 

/* -- Returns a handle to the new window. */ 

/***************************************************** j 
( 

HWND hwnd; 

MDICREATESTRUCT racs; 
char szBuf[50]; 

sprintf(szBuf, "Untitled %d", ++iwndMdi); 

mcs.szTitle ■ szBuf; 

mcs.szClass = szChild; 

mcs.hOwner » hins; 

mcs.x = mcs.cx = CWJJSEDEFAULT; 

mcs.y ■ mcs.cy * CWJJSEDEFAULT; 

mcs.style ■ 0; 

/* Tell the MDI Client to create the child. */ 
hwnd • (HWND)SendMessage(hwndMDI, WM_MDICREATE, 0, 
(LONG)(LPMDICREATESTRUCT)&mcs); 

ShowWindow(hwnd, SW_SH0W); 
return hwnd; 

) 

LRESULT CALLBACK 

MenuHookProc(int wCode, WPARAM wParam, LPARAM IParam) 

j*************★★**★*★*★***★*★★★***★★★****★**★★*★****★★j 

/* -- Examine the message to see if we need to move */ 
/* the menu to a new top-level window. */ 

^*****************************************************y 

( 

HWND hwnd, hwndFirst, hwndLast; 

LPMSG lpmsg = (LPMSG)1Param; 


Cont’d 

BOOL fRight; 

if (flgnoreMessage) 

goto MenuHookProcExit; 

if (lpmsg->message 1= WM_KEYDOWN) 
goto MenuHookProcExit; 

if (!(fRight = 1pmsg->wParam — VK_RIGHT) && 
lpmsg->wParam != VK_LEFT) 
goto MenuHookProcExit; 

/* Any modeless dialogs present? */ 
hwndFirst ■ (HWND)GetProp(hwndMain, szPropNext); 
hwndLast = (HWND)GetProp(hwndMain, szPropPrev); 
if (hwndFirst »■ hwndMain) 

goto MenuHookProcExit; /* Nope. */ 

if ((hwnd ■ GetActiveWindowO) «■ hwndMain) 

{ 

switch (imnu) 

{ 

default: 

goto MenuHookProcExit; 

case imnuFrame: 
if (IfRight) 

goto MenuHookProcExit; 
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user has pressed the right arrow, then the first menu on the 
menu bar should be displayed. 

Case 3: Same conditions as case 2, except if there is an MDI 
child, then the system menu of the active MDI child should be 
displayed instead. Note that if the MDI child has been maxi¬ 
mized, its system menu item appears in the frame window’s 
menu bar (whewl). 

This means that substantial logic is necessary to decide 
which additional keystrokes (if any) need to be simulated to 
activate the required menu item and drop the associated 
popup menu. If a system menu is to be dropped, then you 
can use a convenient shortcut. If you press the space bar 
while in menu mode, the system menu will appear. So the 
first case is handled by posting a UM_KEYDOUN and UM_KEYUP 


message pair with wParam containing VK_SPACE. Once again, 
IParam is important. You no longer need to pretend that the 
user is holding down the A11 key, so use 0x0000001 for the 
key down and OxcOOOOOOl for the key up. 

For case 2, (activating the first menu item of the menu 
bar), you can just simulate a down arrow key press to drop 
the popup menu, since the Alt key simulation has already 
activated the menu item. If there is no associated popup, the 
down arrow is benign —the menu item will remain activated. 

For case 3, you need to move the active menu item back 
from the first menu item in the menu bar to the active MDI 
window. Normally, the menu manager would perform this 
when the user presses the left arrow key, but at this point, if 
you post a UM_ KE YD0MN/MM_ KEY UP pair, the hook procedure will 


Listing 1 

—Cont'd 

hwnd « hwndFirst; 


break; 

SetFocus(hwnd); 

case imnuMDI: 

/* Highlight first menu icon (enter menu mode). */ 

if (fRight) 

PostMessage(hwnd, WM SYSKEYDOWN, VK MENU, 

goto MenuHookProcExit; 

0x20000001); 

hwnd « hwndLast; 

PostMessage(hwnd, WM SYSKEYUP, VK MENU, 

break; 

OxcOOOOOOl);. 

case imnuFirst: /* First non-system menu. */ 

if (fRight) 

if (fRight || hwndMDIActive != NULL) 

{ 

goto MenuHookProcExit; 

/* User hit right arrow. */ 

hwnd = hwndLast; 

if (hwnd ** hwndMain && hwndMDIActive != NULL) 

break; 

( 

} 

} 

else if ((HINSTANCE)GetWindowWord(hwnd, 

if (IsZoomed(hwndMDIActive)) 

( 

/* Default behavior is to highlight */ 

GWW HINSTANCE) == hins) 

/* the MDI's system menu icon that */ 

( 

/* has been placed in the frame's */ 

hwnd = (HWND)GetProp(hwnd, 

/* menu bar, so we're done. */ 

fRight ? szPropNext : szPropPrev); 

\ 

goto NextMenuExit; 

} 

/* User has arrowed off last dialog. */ 

/ 

el se 

{ 

/* There is an active MDI child, so */ 

goto MenuHookProcExit; 

/* activate its system menu icon. */ 

) 

PostMessage(hwnd, WM KEYDOWN, VK LEFT, 

0x00000001); 

PostMessage(lpmsg->hwnd, WM KEYDOWN, VK ESCAPE, OL); 

PostMessage(hwnd, WM KEYUP, VK LEFT, 

PostMessage(hwndMain, wmNextMenu, (WPARAM)hwnd, 

OxcOOOOOOl); 

fRight); 

) 

1pmsg->wParam = VK_ESCAPE; 

) 

else 

MenuHookProcExit: 

( 

return CallNextHookEx(hhook, wCode, wParam, 

/* User hit left arrow. */ 

1Param); 

} 

if (hwnd *« hwndMain) 

( 

/* User has arrowed off last dialog. */ 

VOID 

/* Simulate a <space> to drop the system */ 

NextMenu(HWND hwnd, BOOL fRight) 

/* menu. */ 

/************ **************************** *************i 

vk = VK SPACE; 

/* — Drop the next menu. */ 

) 

/* -- hwnd : Drop menu for this window. */ 

} 

/* -- fRight: If user used right-arrow. */ 


1 *************************************** **************j 
{ 

NextMenuExit: 

PostMessage(hwnd, WM KEYDOWN, vk, 0x00000001); 

BOOL flgnoreMessageSav; 

PostMessage(hwnd, WM KEYUP, vk, OxcOOOOOOl); 

UINT vk = VK DOWN; 



/* Allow the hook proc to work again. */ 

if (HsWindow(hwnd)) 

flgnoreMessage = flgnoreMessageSav; 

return; 

} 

/* Prevent hook proc from going re-entrant. */ 

/* End of File */ 

flgnoreMessageSav = fIgnoreMessage; 
fIgnoreMessage * TRUE; 
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trap it and modify the desired behavior. To get around this, 
you can set a global flag that tells the hook procedure to 
leave all messages alone. After simulating the left key press, a 
down arrow simulation is required to drop the menu (if there 
is one). If the MDI child is maximized, you are in luck, since the 
default behavior for an Alt key press is to activate the MDI 
child's system menu item that has been incorporated into the 
frame’s menu bar. So simulate the left key press only if there 
is no maximized MDI child. 

To determine which menu crossings to look at, given the 
above three cases, the hook procedure needs to be informed 
of the current active menu item. The important menu items 
to keep track of are the system menu item on the frame 
window's menu bar, the system menu item on the active MDI 
child window, and the first menu item of the frame window's 
menu bar. The remaining menu items 
on the frame window’s menu bar can 
simply be lumped into the category 
“other,” since the hook procedure will 
not manage navigation between these 
menu items. 

Finding out when the frame 
window's system menu item is active is 
easy. The frame window will receive a 
#M_MENUSELECT message with the low 
word of l Pa ram (which is a bit field 
array of flags) containing MF_SYSMENU. 

Similarly, the window procedure for the 
MDI child can trap WM_MENUSELECT to 
keep track of when the active MDI 
child's system menu item is active. The 
first menu item on the frame window’s 
menu bar is not so easy. The 
UM_MENUSELECT message will contain 
the menu handle of the associated 
popup menu if the menu item has an 
associated popup menu. You can com¬ 
pare the value of wParam with the 
menu handle of the menu bar's first 
popup menu to see if the first menu 
item is active. But if the menu item 
does not have an associated popup 
menu, there does not appear to be any 
way to distinguish it from other similar 
menu items on the menu bar. If you 
can figure out a way to do it, please tell 
me! The bottom line is that you cannot 
use this scheme if the first menu item 
on the frame window's menu bar does 
not have an associated popup menu. 

An Implementation 

Listings 1 through 5 present a 
sample program which implements this 
scheme. The program has two menu 
items. File drops a popup menu with a 
single entry, New MDI child, which will 
create a new MDI child window each 
time you select it. Uindow drops a 
popup initially containing the single 


entry Modeless dialog. which will create a new modeless 
dialog each time it is selected. This menu is also supplied to 
the MDI manager as the menu to receive new MDI window 
names, for navigation among the MDI children. The MDI menu 
manager does the housekeeping of dynamically maintaining 
MDI child window entries for the menu. The program exhibits 
the keyboard menu navigation of Excel. 

Listing 1 l/ndimenu.c), is the C source code for the pro¬ 
gram. During initialization, the code creates a class for the 
frame window and the MDI children. The frame is created 
(which will in turn create the MDI client), and an initial MDI 
child is created. A procedure instance is created for the 
modeless dialog and the hook procedure, and the message 
hook is installed. 
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#define BOTH (FA I FC) 
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n) 


FB) 
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To keep track of the creation order of the modeless dialogs 
(the creation order is used to determine the interdialog 
navigation order), the code implements a doubly linked list of 
dialog window handles using the window property list For 
non-public system classes (such as dialogs or menus), the win¬ 
dow property list is the ideal way to associate extra informa¬ 
tion on a per-window basis. The other method, using window 
extra words, is not available without creating a new class. The 
head of the linked list is the frame window, which initially just 
points to itself. Upon receiving the private wmNextMenu mes¬ 
sage (posted by the hook procedure), NextMenu() is called to 
perform the menu navigation. 

The MDI child window procedure traps the WM_MENUSELECT 
message to keep track of when an MDI child window's system 
menu item is active. It also traps the WM_MDIACTIVATE mes¬ 
sage to track the active MDI window handle. Similarly, the 
modeless dialog procedure traps the UM_ACTIVATE message to 
track the active modeless dialog window handle. The rest of 
ModelessDlgProcf) is devoted to maintaining the doubly 
linked list. 

MenuHookProcf) is the message hook callback. It first ex¬ 
amines the flgnoreMessage flag to see if the message is 
being simulated and should be ignored. Next, it tests that the 
message is a M_KEYD0UN for either the left or right arrow 
keys, and that there is at least one modeless dialog present. If 
all these conditions are met, logic is executed to determine 
which window to activate. If the frame window is active, the 
logic ensures that the menu crossing is occurring across a 
dialog boundary. An Escape key press is simulated, and, in 
addition, the current message is transformed into an Escape 
key press before returning control to the menu manager's 
modal loop. When GetMessagef) or PeekMessagef) returns, it 
will return the modified message. The last routine, NextMenu() 
simulates the keystrokes required to perform the menu 
navigation. 

Thanks to Didier lalli ( lalli@casee.enet.dec.com) of Digi¬ 
tal Equipment, Centre Technique Europe S.A.R.L., BP027 06901 
Sophia Antipolis Cedex, France, for posing the question that 
prompted this article. □ 


Listing 2 (mdimenu.h) 

/* -- Interface twixt c source and resource files. */ 

/*****************************************************/ 

Idefine idmMdiMenu 0x1000 /* Menu id. */ 

Idefine dlgModeless 0x1000 /* Dialog id. */ 

/* Menultem id's */ 

Idefine idmNew 0x1000 
Idefine idmModeless 0x1001 

/* Number of Menultems in MenuBar. */ 

Idefine cmnu 2 

/* End of File */ 


Header File for mdimenu.c 


Listing 3 (mdimenu.rc) 

/A****************************************************/ 

/* — Resource script file for mdimenu. */ 

/*****************************************************/ 

♦include <windows.h> 

♦include ''mdimenu.h" 

/* Frame window menu. */ 

MdiMenu MENU LOADONCAll MOVEABLE DISCARDABLE 
BEGIN 

POPUP "AFile" 

BEGIN 

MENUITEM "ANew MDI child", idmNew 

END 

POPUP "AWindow" 

BEGIN 

MENUITEM "AModeless dialog...", idnflodeless 

END 
END 

/* Modeless dialog template. */ 

MdiDialog 
DIALOG 
LOADONCALL 
MOVEABLE 
DISCARDABLE 
6, 18, 44, 18 
CAPTION “Modeless" 

STYLE DS MODALFRAME | W$ CAPTION | WS DLGFRAME | 

WS BORDER | WS_P0PUP | WS VISIBLE fw$ SYSMENU 
BEGIN 
END 


Resource Compiler Definitions for mdimenu.c 


Listing 4 (mdimenu.def) 


;; -- Linker module definition file. 


NAME MdiMenu 

DESCRIPTION 'MDI style dialog menu demo' 

EXETYPE WINDOWS 

STUB 'WINSTUB.EXE' 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 2048 

STACKSIZE 8192 

EXPORTS 

FrameWndProc 
MDIChildWndProc 
ModelessDlgProc 
MenuHookProc 

Module Definition File for mdimenu.c 


Listing 5 (makefile) 

####################################################### 
## -- Project file for mdimode program. ## 

####################################################### 
all: mdimenu.exe 

mdimenu.obj: mdimenu.c mdimenu.h 

cl -c -AM -G2w -Od -Zdpe -W3 -DSTRICT mdimenu.c 

mdimenu.exe: mdimenu.obj mdimenu.def mdimenu.rc 

link /N0D/m mdimenu,,, libw mlibcew, mdimenu.def 
mapsym mdimenu 
rc mdimenu 


MSC v7.0 NMAKE File for Building mdimenu. c 
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A Method of Accurate 
Process Tinning 


James L Bates 
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In a complex system, measuring the load generated by a particular process 
or routine can be difficult. For the purpose of optimizing system performance, 
however, knowing which routines affect the total throughput of a system is 
sometimes necessary. One approach is to modify the routine you want to 
profile, so that it starts a timer at the beginning of each invocation and pauses 
that timer when exiting. You could then run the overall program for a fixed 
amount of time and compare the time spent in the target routine with the total 
time spent. 

A difficulty here is that the resolution of the timer tick on the PC (1/18 
second) is too low for accurate profiling. You could obtain the fractional part of 
the timer tick, but the more code you have to execute to obtain accurate 
times, the more skewed will be the results. The ideal solution would allow you 
to execute only a few instructions to start and stop a high-resolution timer. 

This article describes one such solution to the timing problem. This method 
uses a second computer running a timing application called sptimer (which 
stands for signal processing timer). The code that you want to time communi¬ 
cates via COM1 or COM2 with sptimer, which sits in a tight loop, monitoring a 
COM port control line. In the routines to be profiled, you change the entry point 
to raise the appropriate control line and change the exit point to lower the 
control line, sptimer monitors the control line, incrementing a counter that rep¬ 
resents the total time spent by the target program. When the target application 
raises the control line, sptimer sits in another loop, incrementing a counter that 
represents the time spent in the routines being profiled, until the application 
lowers the control line again. At the end of a run, sptimer prints the values of 
both counters. Although the values of the two counters depend on how fast 
the computer is, the ratio of the two counters accurately represents the per¬ 
centage of time consumed by the code you are profiling. 

Communicating with sptimer 

Enabling code to communicate with sptimer requires only a few instructions 
at the beginning of the routine — to raise either RTS (Request To Send) or DTR 
(Data Terminal Ready) — and another small set of instructions at the end —to 
lower them. These commands are small enough that they will usually have no 
effect on the dynamics of the test system. 


I 1 I I ... l. 


Jim Bates spent 10 years in systems engineering before venturing out with his 
own consulting business in 1980. Jim writes and develops DOS and Windows 
software for various hardware and software companies. His applications have 
included compilers and interpreters, with emphasis on communications 
simulators and servers -and some of his work is present in several of today’s 
leading software packages. He may be contacted c/o Cogitate at (313) 352-2345. 
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sptimer uses the two RS232 control 
lines (DTR and RTS) for different pur¬ 
poses. One line defines the outside 
timing envelope (the total time spent): 
you simply raise the line (the DTR in the 
example) at the point in your program 
where you want the profiling session to 
begin and lower it where you want the 
session to end. This allows you to ex¬ 
clude startup housekeeping (such as 
opening files) and miscellaneous over¬ 
head associated with ending the pro¬ 
gram (such as flushing buffers and clos¬ 
ing files) from the profile. 

You raise and lower the second con¬ 
trol line (RTS) around the routine (or 
routines) whose load you want to 
measure. The second computer, which 
is running sptimer, knows the timing 
envelope from the DTR line and it can 
determine the timed routine's fractional 
part of the total time by watching the 
RTS line. 

Listing 1 (cometrl. asm) contains the 
code fragments that raise and lower 
the DTR and RTS control lines in the 
model. As Listing 1 shows, you can 
modify the routines to use COM2 by 
changing the 03FCh port address to 



Don’t waste it typing 
in endless listings. 


Windows/DOS 

Developer’s Journal 

magazine code listings 
are already on disk. 


They’re only $5 per 
issue, or $20 for either 
1991 or 1990. (That’s the 
entire year!) 

Call today - and 
save yourself some 
time! 


CALL 913-841-1631 
fax 913-841-2624 


Listing 1 (comctrl.asm) 


SPport 

equ 

» 

equ 

SPdtr 

equ 

SPrts 

equ 

V 

StartTimer 


StopTimer 


RoutineOn 


RoutineOff 


03fch 

02fch 

1 

2 


for corn 
for COM2 

Data Terminal Ready 
Request to Send 


macro 


Timing Envelope Begin 

; push 

ax 

optional, see note 1 

; push 

dx 

optional, see note 1 

mov 

dx,SPport 

modem control port 

mov 

al,SPdtr 

DTR (outside envelope start) 

out 

dx,al 

raise DTR on comm port 

jmp 

short $+2 

optional, see note 2 

; pop 

dx 

optional, see note 1 

; pop 

ax 

optional, see note 1 

endm 


end of macro 

macro 


Timing Envelope End 

; push 

ax 

optional, see note 1 

; push 

dx 

optional, see note 1 

mov 

dx,SPport 

modem control port 

mov 

al.OOh 

DTR (outside envelope start) 

out 

dx,al 

drop DTR on comm port 

jmp 

short $+2 

optional, see note 2 

; pop 

dx 

optional, see note 1 

1 pop 

ax 

optional, see note 1 

endm 


end of macro 

macro 


Routine Timing Begin 

; push 

ax 

optional, see note 1 

; push 

dx 

optional, see note 1 

mov 

dx,SPport 

modem control port 

mov 

al ,SPdtr+SPrts 

RTS (select signal) 

out 

dx,al 

raise RTS on comm port 

jmp 

short $+2 

optional, see note 2 

; pop 

dx 

optional, see note 1 

i pop 

ax 

optional, see note 1 

endm 


end of macro 

macro 


Routine Timing End 

; push 

ax 

optional, see note 1 

; push 

dx 

optional, see note 1 

mov 

dx,SPport 

modem control port 

mov 

al.SPdtr 

RTS (deselect signal) 

out 

dx.al 

drop RTS on comm port 

jmp 

short $+2 

optional, see note 2 

; pop 

dx 

optional, see note 1 

; pop 

ax 

optional, see note 1 

endm 


end of macro 


Note 1 The pushing and popping will add some overhead to the 
model, use only if the contents of either of the 
registers must be preserved. 

Note 2 This JMP just past itself is in effect a delay, not 
in the cycle times it takes, but the affect it has 
on the CPUs look-ahead buffer. 


•MODEL SMALL 
•STACK 100 
.CODE 

main proc near 

mov ax,@data 

mov ds,ax 


Define the Comm Port for Signal Processing 
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Listing 1 —Cont’d 

mov 

es,ax 

> 

Housekeeping 

call 

process 

> 

process primed and ready to go 

> 

StartTimer 

» 

> 

model outside of test routines 

> 

mov 

bx,10h 

loop_l: call 

process 


routine under test 

RoutineOn 

cal 1 

process 

RoutineOff 


continue outside test routines 

call 

process 

dec 

bx 

jnz 

loop_l 

» 

» 

process completed 

StopTimer 

* 

» 

Close and Exit 

call 

process 

main exit: 


mov 

ax,04c00h 

int 

21h 

main endp 


process proc 

near 

mov 

ax,10h 

xor 

cx,cx 

plloop: loop 

plloop 

dec 

ax 

jnz 

plloop 

ret 


process endp 


end 

main 

; End of File 



Listing 2 (sptimer.c) 

i* 

** James L. Bates 

** Batech Corporation 

** c/o Cogitate, Inc. 

** 24000 Telegraph 

** Southfield, MI 48034 

★ ★ 

** Signal Process Timer 

** + Using RS232 serial interface control/status lines 

** + Use DTR/DSR for outside timing envelope trigger 

** + Use Keyboard to supplement outside timing envelope trigger 

** 

*/ 

linclude <stdio.h> 
linclude <conio.h> 
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Listing 2 — Cont’d 


unsigned long 
unsigned long 
unsigned long 
unsigned long 


c_off; 
c_total; 
elapsed_time; 
elapsed_seconds; 


/* Attempt to normalize the two numbers to integers */ 
unsigned int CommonDenominate(on,id) 
unsigned long on; 

unsigned int id; 

I 

unsigned long e_on, e_off, ls_on, ls_off; 
unsigned int p_on, p_off, p_total; 

/* Round c_on and c_c_off to reasonable levels */ 

c_off - c_total - on; 

ls_on = on; 

ls_off = c_off; 

while (1) 

f 

if (on ■* 01) 

( if (c off == 01) 

{ ' c_off = 11; 

on *11; 

break; /* both zero *7 

) 

c_off * 11; 
on * 01; 
break; 

) 

if (c_off == 01) 

( on - 11; 

break; 

} 

while ( on > 10000 || c off > 10000 ) 

{ 

on++; 
on »= 1; 
if (on == 01) 

on = 11; 

c_off++; 
c_off »= 1; 
if (c off == 01) 

c off - 11; 

} 

break; 

} 

p_total = (int) (on + c_off); 

p_on = (int)((on *10000)/(1ong)p_total); 

p_off = (int)((c_off*10000)/(longjp_total); 

e_on = (( elapsed_time * on ) * 55 ) / (long)p_total; 

e_off = (( elapsed_time * c off ) * 55 ) / (long)p_total; 
printf("%d %41d.%031d %3d.%02d%% %41d.%031d %3d.%02d%% %41d.%031d\n" 
id, 

e_on/1000,e_on%1000, 
p_on/100,p_on%100, 
e off/1000,e off%1000, 
p“off/100,p_off%100, 

elapsed_seconds/1000,elapsed_seconds%1000 ); 
return (int)on; 


main() 

{ 

unsigned int 
unsigned int 
unsigned int 
unsigned long 
unsigned long 


addr; /* async comm port address */ 
val; /* async comm port buffer */ 
kb_env; /* keyboard timing envelope */ 
c_onl; 

start_time, stop_time; 


addr = 0x03fe; 


printf("SPTIMER - Signal Processing Timer..An"); 
printf( H ....press any data key to start/stop\n"); 
printf( M or wait for DSR trigger signal.. An"); 


c onl = 01; 
c’off = 01; 

/* Wait for Outside Timing Envelope Trigger */ 

kb_env = 1; /* initialize to kb timing envelope */ 
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02FCh. These also use the ax and dx 
registers and may have to be saved 
with pushes and pops. The final instruc¬ 
tion (jmp short $+2) is necessary to 
clear the CPU’s lookahead buffer and 
give the port time to digest the pre¬ 
vious I/O instruction. Call these routines 
at the appropriate points to start and 


end the timing envelope and to start 
and end the timing of the routine(s) 
under test. 

The sptimer Side 

sptimer.c (Listing 2) monitors the 
DTR line (the timing envelope) and com¬ 
putes, using the hardware timer, the 


Listing 2 — Cont’d 


while (IkbhitO) 
( 


—1 

3 

O 

< 

dx.addr 

; comm port address 


xor 

ax, ax 

; clear for int val 


in 

al ,dx 

; read the modem status 


mov 

val,ax 

; save the status value 


/ 

if ( val & 0x20 ) 

/* DSR raised high? 

*/ 

{ kb_env 

- 0; 

/* DSR timing envelope 

*/ 

break; 

} 


/* exit the while loop 

*/ 

triggered by keyboard and not DSR 



read the kb character 


*/ 

if {!i 


vaU0x20)) 
getch(); 


/* if DSR not raised high */ 

/* then we must have a kb trigger */ 


*/ 

puts(' 


the following puts is for visual confirmation only. 
It lets us know that our triggers are working, but 
it may also skew the timing somewhat, since putting 
these characters to the screen may take time. 

Remove for more accurate timings. 


..timing.."); 


/* this may skew timing 


get_time(&start_time); 

(•include "spl.inc" 

get_time(&stop_time); 

/* if terminated by keyboard and not DSR 
** read the kb character */ 

if (kbhit()) 

getch(); 

/* Outside Timing Envelope Complete */ 
c_total - c_onl + c_off; 
elapsed_time * stop_time - start_time; 
elapsed_seconds = (elapsed_time*55); 

printf("start:%ld stop:%ld elapsed:%ld\n“, 
start_time,stop_time,elapsed_time); 
printf("on:%ld off:%1d total %ld\n”, 
c_onl, c_off, c_total ); 

printf(" .-ON.—OFF.T0TAL-\n"); 

printf("# seconds percent seconds percent secondsV); 
CommonDenominate(c_onl,l); 


get_time(time) 
long ‘time; 

( 

_asm 

push 

mov 

mov 

mov 

mov 

mov 

mov 

mov 

pop 

) 

) 


es 

bx.time 

ax,040h 

es.ax 

ax.es:[06ch] 
0[bx] ,ax 
ax,es:[06eh] 
2[bx] ,ax 
es 


/* End of File */ 
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elapsed time to the nearest tick (1/18 of a second). During this 
timing envelope, sptimer sits in a small loop counting the 
number of times it sees RTS (actually CTS, from its perspective) 


Listing 3 (spl.inc) 


/* 

** SPl.INC 

•kit 


** James L. Bates 

** Batech Corporation 

** c/o Cogitate, Inc. 

** 24000 Telegraph 

** Southfield, MI 48034 

** 

** Tally ratio of timer_on/timer_off using 

** minimal _asm coding. 

*/ 

while (IkbhitO) 

{ 

asm 


mov 

dx.addr ; 

; comm port address 

xor 

ax,ax ; 

; clear for int val 

in 

al,dx ; 

; read the modem status 

mov 

X 

«3 

rd 

> 

; save the status value 


if (!kbenv && I(val&0x20)) 
break; 

if ( val & 0x10 ) 

c_onl++; /* increment timer on */ 

el se 

c_off++; /* increment timer off */ 


Figure 2 


Using SP1.INC: 

SPTIMER - Signal Processing Timer... 

....press any data key to start/stop 
or wait for DSR trigger signal... 

..timing.. 

start:859219 stop:859952 elapsed:733 
on:136027 off:273227 total 409254 

.ON.OFF.T0TAL- 

# seconds percent seconds percent seconds 
1 13.399 33.23% 26.915 66.76% 40.315 


Using SP2.INC: 

SPTIMER - Signal Processing Timer... 

....press any data key to start/stop 
or wait for DSR trigger signal... 

..timing.. 

start:854233 stop:854967 elapsed:734 

on:7106479 off:14343395 total 21449874 

.ON.OFF.T0TAL- 

# seconds percent seconds percent seconds 
1 13.374 33.12% 26.995 66.87% 40.370 


Output from Two Versions of sptimer.exe 
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high or low. These counts give the ratio of time that the tar¬ 
get system is in or out of the routines in question. 

Once a test is completed, sptimer prints the total of the 
counts, percentage, and the elapsed time in and out of the 
timed routines. These times are very accurate since the 
granularity is based upon the time the sptimer computer 
'takes to execute the main timing loop. This loop is very small, 
hence the timing granularity is typically measured in 
microseconds. 

You will need to cable the two computers together with a 
null modem cable. Typical null modem cables or modem 
eliminators are constructed as shown in Figure 1, but sptimer 
requires only three wires: the signal ground (7-7), the RTS/CTS 
pair (4-5), and the DTR/DSR pair (20-6). 


How High Is the Resolution? 

A standard 4.77MHz PC can test the modem status lines 
16,000 times per second; a 486/33MHZ PC can test them over 
450,000 times per second. That means the 486/33MHZ com¬ 
puter can test the status lines every two to three 
microseconds and the standard PC can test these lines every 
60 or so microseconds. 

I have included two different versions of the timing loops 
that sptimer uses, one written mostly in C ( spl.inc , Listing 3) 
and another that uses assembly language extensively 
(sp2. inc, Listing 4). Figure 2 shows the speed (and, hence, 
resolution) improvement that the assembly language version 
offers. 

Both spl.inc and sp2.inc provide a keyboard trigger to 
stop sptimer 's outside timing envelope. This makes the 
routine better behaved, allowing the 
user to get out of the program without 
rebooting the machine. As Figure 2 
shows, however, these keyboard tests 
can degrade performance significantly. If 
you want a really efficient sptimer, 
leave out the keyboard tests and 
relegate the test to reboot if required. □ 


Notice to Our 
Subscribers 

Occasionally, Windows/DOS 
Developer's Journal makes its 
mailing list available to vendors 
of products we think our 
readers will find interesting. Cur¬ 
rent subscribers receive free in¬ 
formation in the mail from 
these vendors. 

If you prefer that your name 
not be used in these mailings, 
please let us know. Just copy or 
clip this form and send it with 
your name and address to: 
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Listing 4 (sp2.inc) 


★★ 

★★ 


SP2.INC 


★ ★ 

James 

L. Bates 


★ ★ 

Batech Corporation 


*★ 

c/o Cogitate, Inc. 


★ ★ 

24000 Telegraph 


*★ 

Southfield, MI 48034 


★ ★ 




★ * 

Tally ratio of timer on/timer off using 

*★ 

more 

asm coding than c 

and c library coding 

★ ★ 

to will provide better throughput. 

*/ 




asm 



{ 

push 

es 

; save segment 


push 

bx 

; save possible index 


mov 

ax,40h 

; point es to DOS area 


mov 

es,ax 

l 


mov 

bx,es: [6ch] 

; get the lsw of timer tick 


mov 

dx.addr 

; get modem status address 

asm_ 

loop: 




in 

al ,dx 

read the modem status 


test 

al,10h 

test for CTS 


jz 

asm_cntl 

not on 


add 

word ptr c onl+0 

,1 j increment timer on 


adc 

word ptr c onl+2,0 ; 


jmp 

short asm cnt2 


asm cntl: 




add 

word ptr c off+0 

, 1 ; increment timer off 


adc 

word ptr c off+2,0 ; 

asm_ 

_cnt2: 




cmp 

bx,es:[6ch] 

stay in tight loop until ti 


jz 

asm loop 

same tick 


mov 

bx,es:[6ch] 

update tick register 


cmp 

kb_env,0 

trigger on kb only? 


jnz 

asm kbhit 

yes... 


test 

al,20h 

DSR still on? 


jz 

asm break 

no, time to exit 

asm_ 

kbhit: 




mov 

ah,l 

; now check the keyboard 


int 

16h 

; keyboard status 


jz 

asm loop 

; no key hit 

asm_ 

break: 




pop 

bx 

; restore possible index 


pop 

es 

; restore segment 


September 1992 


Windows/DOS Developer’s Journal — Page 39 






■ User Report 


STAT! 


Preview by Marc Briand 


You may have seen or even used hardware debuggers, 
emulators, or logic analyzers. Magazine ads for these devices 
show fat ribbon cables hanging from the computer, and miles 
of hex code scrolling by on a CRT. To a software person, that 
is intimidating stuff, so when a hardware timer board came to 
me in the mail, I was a little apprehensive. To my relief, I 
found that not everything under the category “realtime 
hardware" need be complicated or unwieldy. 

STATI, from Alpha Logic Technologies, is a timer board and 
object library that you can use to develop, test, and debug 
realtime software. There are no ribbon cables hanging from 
this board, only an intriguing pickle switch. This PC/XT/AT/EISA- 
compatible board contains counters, frequency generators, 
and interrupt generators, which you can combine in a variety 
of ways for custom timing operations. The object library 
provides several levels of access to the timer board functions, 
ranging from high-level functions like StartElapsedTimer() to 


Product Information 

■ Product: STATI 

■ Price: $295 

Includes STAT! card, object library on dual media, 
breakout switch, and manual. Contact: 

Alpha Logic Technologies 
2121 152nd Avenue NE 
Redmond, WA 98052 
(206) 644-3094 


lower-level functions like ClearNmi (). You can also access the 
hardware registers on the board directly. The package 
provides header files in both .h and . inc formats, to facilitate 
use of the object library with C or assembly language 
programs. 

Hardware Overview 

As Figure 1 shows, the STAT I board contains five timers. 
Each timer is a 16-bit counter that may be clocked by one of 
six onboard frequency generators, or by the output of another 
timer. These timers are extremely versatile devices. They can 
be loaded with any 16-bit value-, they can be sampled at any 
time-, they can count up or down, in binary or BCD. You can 
cascade them in any combination, including all five stuck 
together as one 80-bit timer (using the lowest frequency set¬ 
ting, this 80-bit timer would take 10' 6 years to roll over). 

Each timer can be programmed to produce a pulse output 
when it reaches overflow (or underflow, if it is counting down). 
In addition, you can program the first two timers to pulse 
when they reach a preprogrammed "alarm" value. These pul¬ 
ses can clock other timers, or generate interrupts, as discussed 
later in this article. 

Counters have to have something to make them count; 
that is where STATI’s six frequency generators come in. Fre¬ 
quency generator FI produces a fixed frequency of 4MFIz, for 
a resolution of 250 nanoseconds. F2 through F5 each provide 
one frequency, with F2 producing the highest frequencies and 
F5 producing the lowest. If you select binary mode, F2 thru F5 
will produce "binary” frequencies that are related to FI by a 
power of 16. If you select BCD mode, F2 through F5 will 


M arc Briand is an electrical engineer at Beech Aircraft Company in Wichita, KS. He programs PCs at work and flies airplanes for fun. 
He also writes software for fun at home, striving always to "learn more than I forget each dag." 
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produce "BCD" frequencies that are related to FI by a power 
of 10. There is only one mode control for all four generators, 
so you cannot generate binary and BCD frequencies at the 
same time. F6 is not really a generator, but a scaler. You can 
program it to divide any frequency generated by FI through 
F5, by an integer from 1 to 16. That gives you a total of 144 
different timing frequencies or “resolutions”, ranging from 
4MHz (250-nanosecond resolution) to 3.8 Hz (262-millisecond 
resolution). 

The STATI board contains hardware to generate interrupts. 
When you install the board in the computer, you set a jumper 
to select one of six interrupt levels. When the board senses an 
interrupt condition (programmed by you), it will assert an in¬ 
terrupt request on one of the computer's interrupt request 
lines, IRQ2 through IRQ7. IRQ2 through IRQ7 are standard ex¬ 
pansion bus lines on all PCs (ATs have eight more - IRQ8 thru 
IRQ 15) and, when serviced, will execute corresponding inter¬ 
rupt service routines, pointed to by vectors OAh through OFh. 

The STAT! board generates an interrupt request when a 
preprogrammed condition is met. The board lets you program 
only one condition at a time, including timer overflow or timer 
alarm (you select which timer), or closure of the external 
breakout switch. 

Finally, the board comes with an external breakout switch, 
which I irreverently called a “pickle” switch earlier in this ar¬ 


ticle. If you use your imagination, it looks like a small pickle 
on a three-foot cord, with a little black button on top. The 
black button is part of a momentary switch, that you can use 
to trigger a board-level interrupt or a nonmaskable interrupt, 
depending on how you program the board. 

Applications 

Flardware is nice, modes are nice, but what can you really 
do with this board that you could not do with a PCs built-in 
timing chips and a little clever software? As it turns out, quite 
a bit. To illustrate, here is a brief description of the timing 
hardware that is standard with every PC-compatible com¬ 
puter: 

1. Every PC-compatible computer (from PC through AT) con¬ 
tains an Intel 8253, or an 8254, or equivalent programmable 
interval generator. This is the chip that provides the timer tick 
interrupt, which occurs 18.2 times per second. The timer tick 
interrupt is the only way the PC and XT models have to tell 
time. Every time a timer tick interrupt occurs, a tick counter is 
incremented. You can read the tick counter or set it to a new 
value through the PC BIOS functions. You can also comman¬ 
deer the interrupt, but you need to take care to pass control 
on to the original timer tick interrupt service routine when 
you are finished. 
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of time-of-day down to the second, and continues to run 


COMPUTER SYSTEMS 

ANALYST 

Growing, international, technical publishing company 
is seeking a full-time position which includes XENIX 
system administration; software development and 
maintenance; customer technical support; and 
hardware installation and maintenance. Candidates will 
be familiar with application development using modern 
database tools, be willing to relocate, be able to work 
within a team, and maintain their own code in addition 
to the code developed by others. B.S. in computer 
science or equivalent experience required. Interest in 
technical writing preferred. 

RSlD Publications, Inc. is an equal opportunity employer 
concerned with creating a pleasant work atmosphere. 

If you are looking for an enjoyable working environment 
with a reliable company, please send a cover letter and 
resume to; 

Kelly Calvert, Human Resources Manager 

1BOI West 23rd St., Suite 200 
Lawrence, KS 66046 



publications, inc. 


The RTC also generates interrupts, 1024 times/second, which 
normally don’t do much of anything. You can grab this inter¬ 
rupt as well, and you can also program the RTC to generate 
the interrupt when time-of-day reaches a predetermined 
value. For what it's worth, the RTC can also be programmed to 
set a bit in memory after a specified time interval in 
microseconds. (Since you will have to poll that memory loca¬ 
tion to see if it is set, it's difficult for me to see how you could 
use this feature with any precision.) 

So, you can do a few things with the hardware that comes 
with your PC. In fact, many programming languages provide 
keywords or library functions to access the timing hardware 
and shield you from the nasty details; you can measure time 
intervals or generate programmed delays without even know¬ 
ing anything about the BIOS or the underlying hardware. 

But in the wide world of testing, whether it be flight test¬ 
ing or software testing, what you don’t know can kill you. For 
example, my Borland C++ compiler supplies a library function 
called ftime() which, when invoked, is supposed to pass 
back the current time, through a pointer to a structure. The 
structure contains a millisecond field. Oh boy! But that does 
not mean l can measure milliseconds with any kind of ac¬ 
curacy, because the time that is passed back is only updated 
every 55 milliseconds. Worse, it gets rounded to the nearest 
hundredth of a second. And what is really awful is that the 
milliseconds do not change by the same amount each time-, 
they alternately increment by 50, then 60, milliseconds at 
each update. 

What if you have written your software application to util¬ 
ize the RTC or the timer tick interrupt at your customer’s site? 
That is a perfectly reasonable thing to do, as long as you are 
not doing anything that requires much timing accuracy. How 


Page 42 — Windows/DOS Developer’s Journal 


September 1992 










are you going to perform timing tests on your product "in the 
lab", using the PC's timing chips, when they are already being 
used by the product under test? Your C library reference 
probably neglected to describe what kind of hardware it util¬ 
izes, or what happens if something else is depending on that 
hardware. 

Whatever kind of test you are performing, you want to 
eliminate interactions between the test equipment and the 
thing being tested. You want to be sure you have enough 
resolution to have a meaningful test. And you want to know 
that if you can measure something to four decimal points, it 
really is accurate to four decimal points. If you have a function 
that returns time in milliseconds, that function may require 
tens or hundreds of microseconds to execute. Unless you have 
taken this into account, your test results may be puzzling at 
best, worthless at worst. 

The above discussion points to the occasional need for 
real-time test equipment that is independent of the standard 
PC hardware and that provides greater resolution and ac¬ 
curacy. Given this need, it appears that a product like STAT! 
could be very useful to real-time programmers. Potential ap¬ 
plications for the STAT! board might include: 

Profilers - You can buy commercial profilers to measure 
the execution time of your code, but many of them rely on 
standard PC timer hardware, which means poor time resolu¬ 
tion. These profilers use statistical techniques (e.g., multiple 
runs of your code) to enhance effective time resolution, which 
means that they are often slow. And they still deliver only an 
approximation to the execution time of your code. They simp¬ 
ly cannot run your code without slowing it down, and they 
will compete with your code for use of the PC's timing 
hardware. Despite these limitations, profilers are good tools for 
identifying major sections which need work and for helping 
you understand what is happening (interrupt activity, I/O calls, 
etc.). 

The STAT! board, on the other hand, can measure time 
intervals down to 250 nanoseconds (actually, this statement 
needs some interpretation - see "Cautions, Concerns, and Out¬ 
right Gripes” later in this article). So once you have identified a 
function or block of code that is hogging processor time, you 
ran zero in on it with STAT!. You can embed STAT! functions 
in your source code to measure the execution times of single 
statements or of the underlying assembly code. 

Animation - The breakout switch is potentially useful for 
timing animation sequences. Since the breakout switch can 
trigger interrupts, you can write interrupt service routines to 
measure elapsed times on successive activations of the 
switch; so you can measure exactly how long it takes some¬ 
thing to move across the screen. You can fine-tune animation 
a lot faster this way than by just guessing what kind of delays 
to stick into your code and recompiling, and guessing and 
guessing again. 

Watchdog - The STAT! board can also be used as a 
watchdog timer. A watchdog is a small circuit that “barks" 
when it does not receive enough attention from the proces¬ 
sor. The bark is an interrupt; to prevent an interrupt the 
processor has to keep resetting the watchdog timer at peri¬ 
odic intervals, if the processor can manage to do that, it’s 
probably OK. But if the processor hits a wild pointer, the 


watchdog will bark and get the program back into a place 
where it can recover. 

if you are working the bugs out of real-time code that 
occasionally hangs your computer, a watchdog timer can get 
you back up and running without having to reboot. 

Simulation - Suppose you have written a realtime pro¬ 
gram that talks to something in the outside world, then waits 
for a response in the form of an interrupt. You want to test it 
without actually hooking it up - no use blowing up the fac¬ 
tory. You can use STAT! to trigger those interrupts on a ran¬ 
dom or periodic basis, making your program think it is actual¬ 
ly doing something. 

Cautions, Concerns, and Outright Gripes 

As with anything, there are a few things about STAT! not 
to like, or, at least, to ponder for a while. Some of these are 
minor irritations, others are more serious, and some probably 
just cannot be helped. 

Inaccuracy in measurement is something that probably 
cannot be helped. While the STAT! board can measure time 
intervals with 250-nanosecond resolution, it is not really pos¬ 
sible to get 250-nanosecond accuracy. That is because the 
function calls to access the timers require a finite amount of 
time to execute. Unfortunately, the actual time required is dif¬ 
ficult to predict because it depends on the type of computer 
and system clock speed. 

The STAT! board and software were well-designed to mini¬ 
mize this timing error. The board employs a register scheme 


FullShot 

The Complete Image Capture 
Program tor Microsoft® Windows™ 

FullShot is perfect for images you want to 
include in manuals, interface design, training 
handouts, presentations, or marketing materials. 

□ Capture images using hotkeys or the FullShot icon 
Q Choose hotkeys interactively (see below) 

Q Capture a full screen or any part of a screen 
Q Capture windows in many different ways 
Q Capture black-and-white, 16-color, and 256-color images 

□ Translate color images to gray patterns or black & white 
Q Resize, scale, flip, rotate, and crop images 

Q Export to and import from BMP, TIFF, PCX, and CLP 
Q Support all Windows graphics cards and printers 
Q Print in color, gray pattern, or black-and-white 

Only $ 99 95 

To Order Call 

1-800-227-1788 

INBIT 

P.O. Box 391674 
Mountain View, CA 94039 
415-967-1788 Fax:415-967-8614 

INBIT and FullShot are trademarks of INBIT. Microsoft Windows is a trademark of Microsoft. 
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CARE 


We're in 
a growth 
industry. 

In our business, 
growth is essential. 
So we help farmers 
grow more food. 
Communities grow 
more self-sufficient. 
Mothers grow 
more hopeful. 
And children 
grow up healthy. 


1-800-521-CARE 


Listing 1 (calib.c) 

/*===================.=====.=============. 

calib.c: program to demonstrate calibration and use of STAT! timing 
functions 

===================================.*/ 

linclude <dos.h> 
linclude <graphics.h> 
linclude <stat.h> 

Idefine ZER0W0RD 0x0000 

Idefine ALLTIMERS TFT1|TFT2|TFT3|TFT4|TFT5 
#define TIMERS12 TF_T1|TF_T2 
#define STATI0ADR 0x0250 
Idefine FI RES 250 


/*. 

CalibrateOverhead: 

Function to determine the average overhead incurred by a call to 
LoadTimers() followed by a call to SaveTimersO; This function assumes 
that the STAT! board has already been initialized. 

Arguments: n - number of samples to average 

Return value = average overhead in nanoseconds 
.*/ 

float CalibrateOverhead(unsigned n) 

{ 

unsigned i; 
unsigned diff = 0; 

/* Configure all timers to count up in binary, from freq. generator 1 */ 

ConfigTimer(TN_Tl,TS_Fl,TC_REPEAT,TD_UP,TB_BIN,TM_OFF); 
ConfigTimer(TN_T2,TS_Fl,TC_REPEAT,TD_UP,TB_BIN,TM_0FF); 
ConfigTimer(TN_T3,TS_Fl,TC_REPEAT,TD_UP,TB_BIN,TM_0FF); 
ConfigTimer(TN_T4,TS_Fl,TC_REPEAT,TD_UP,TB_BIN,TM_0FF); 
ConfigTimer(TN_T5,TS_Fl,TC_REPEAT,TD_UP,TB_BIN,TM_0FF); 

/* place 0 in all timer load registers */ 

WriteTimerLoad(TN_T1,ZER0W0RD)j 
WriteTimerLoad(TN_T2,ZER0W0RD); 

WriteTimerLoad(TN_T3,ZER0W0RD); 

WriteTimerLoad(TN_T4,ZER0W0RD); 

WriteTimerLoad(TN_T5,ZER0W0RD); 

/* Start all timers */ 

ArmTimers(ALLTIMERS); 

/* loop - each time through, measure difference, add it to diff */ 

disable(); /* disable pesky timer tick and RTC interrupts */ 

for(i=0;i<n;i++){ 

LoadTimers(ALLTIMERS); /* zero the timers */ 

SaveTimers(ALLTIMERS); /* sample the timers */ 

diff += ReadTimerHold(TN_Tl); /* read sampled value from timerl */ 

}; 

enablef); /* reenable pesky interrupts */ 

/* Turn off timers */ 

DisarmTimers(ALLTIMERS): 

/* return average overhead */ 

return(F1_RES*(f1 oat)diff/(f 1 oat)n); 

): 


Calibrating Timing Overhead 
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(see Figure 2) which does not allow you 
direct access to the timers. If you want 
to load a value into a timer, you must 
first load it into the timer’s LOAD 
register, then transfer the contents from 
the LOAD register to the timer; if you 
want to read the current contents of a 
timer, you must first transfer its con¬ 
tents to a HOLD register, then read the 
contents of the HOLD register. Although 
this scheme might seem needlessly in¬ 
direct, it actually makes a lot of sense. 

Suppose you want to measure a 
time interval with a 32-bit timer (2 
timers cascaded). First you fill the 2 
timers' LOAD registers with zeros. Don't 
worry that you cannot do all of this 
with one bus cycle; you're not in the 
time-critical portion of the test yet. To 
start the time measurement, you call 
the LoadTimersf) function. The Load- 
Timers () function uses an 80x86 OUT 
instruction to make both timers load 
from their LOAD registers, simultaneous¬ 
ly. The beauty of LoadTimersf) is that 
it can load all five timers at once, if 
need be. You specify which timers to 
load by setting bits in an argument 
word. To complete the time measure¬ 
ment, you call SaveTimers(). Save- 
Timers () uses another OUT instruction to transfer the current 
contents of the timers to their HOLD registers. Now you have 
completed the time measurement and have all the time in 
the world to read the HOLD registers and interpret the results. 
The actual time interval measured is between LoadTimersf) 
and SaveTimersf), and these functions are fast. 

All STAT! functions are written in assembly language, and 
the source code is provided with the board. LoadTimersf) 
and SaveTimersf) executed in about 3 microseconds each on 
my 33-MHz 486 clone. (Incidentally, I determined this by using 
the STAT! board). You could make these functions even faster 
by writing assembly code specific to the timers you wanted 
to use, thus eliminating the need to pass an argument. 

You can also calibrate out most of the error in Load- 
Timersf) and SaveTimersf). Listing 1 demonstrates a func¬ 
tion, CalibrateOverheadf) , which uses STATI's own timing 
circuitry to measure the timing overhead incurred when you 
bracket your code with LoadTimersf)/SaveTimersf). Since 
these two function calls in CalibrateOverheadf) are bracket¬ 
ing nothing (zero time duration), any time measured in 
CalibrateOverheadf) must be due to the time cost of brack¬ 
eting. 

None of this kind of information appears in the STAT! user 
manual. Apart from calling the company for technical support, 
you are pretty much on your own to figure this stuff out. 
Though the manual is fairly well-written and organized, I think 
it is inadequate for people who are really serious about ac¬ 
curacy. I would like to see a chapter discussing all the pitfalls 
and do's and don'ts of time measurement. 
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Listing 1 — Cont’d 


/*.-.-. */ 

/* Program to demonstrate function CalibrateOverheadQ */ 

/* Measure execution time required to draw a circle */ 


main() 

{ 

int j; 

float overhead; 

unsigned long RawCircleTime; 

float CookedCircleTime; 

int gdriver = DETECT, gmode, errorcode; /* BG1 init variables */ 

/* initialize STAT! board */ 

SetStatAdd(STATlOADR); 
if(!InitStat())( 

printf("STAT! board Init problem. Press key to continue.. .\n"); 
getch(); 

); 

/* Determine Load/Save overhead. Do this first since this function alters 
configuration of timers */ 

overhead ■ CalibrateOverheadf100); /* average over 100 measurements */ 

/* Configure timers 1 & 2 as a cascaded counter to count up in binary, 
with 250 nanosecond resolution. Counter 1 is LSW, counter 2 is MSW */ 

ConfigTimer(TN_Tl,TS_Fl,TC_REPEAT,TD_UP,TB_BIN,TM_OFF); 

ConfigTimer(TN_T2,TS_TNM1,TC_REPEAT,TDJJP,TB_BIN,TM_0FF); 
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Listing 1 — Cont’d 


/* Load timers 1 & 2 LOAD registers with zeroes in preparation for time 
measurement - go ahead and start timers */ 

WriteTimerLoad(TNT1,ZEROWORD); 

WriteTimerLoad(TN_T2,ZER0W0RD); 

ArmTimers(TIMERS12); 

/* In this section we will measure how long it takes to draw a circle */ 

initgraph(&gdriver, &gmode, "c:\\lnguages\\bc\\bgi“); 
LoadTimers(TIMERS12); /* start measurement now */ 
circle(300,200,50); 

SaveTimers(TIMERS12); /* sample elapsed time to draw circle */ 
getch(); /* wait for user to finish looking at circle */ 

closegraphO; 

/* Read timer hold registers and figure out how long it took to draw 
circle. Print results */ 

RawCircleTime « 65536*ReadTimerHold(TN_T2) + ReadTimerHold(TN_Tl); 
CookedCircleTime * RawCircleTime*Fl_RES - overhead; 

printf("Load/Save overhead » %f nanoseconds\n".overhead); 
printf("Raw Circle Counts = %lu\n",RawCircleTime); 

printf("It took %f nanoseconds to draw the circle\n",CookedCircleTime); 


/* End of File */ 
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Concerning the breakout switch, the 
manufacturer chose to enable non¬ 
maskable interrupt requests from this 
device upon powerup of the computer. 
That means that if you just turn on 
your computer to do some word 
processing, and you push that switch, 
your word processor will probably go 
'‘poof." And if you are like me, you will 
eventually push that switch. This is not 
a big deal, really - you can always un¬ 
plug the switch - but you sure notice it 
the first time it happens. As it turns out, 
Alpha Logic made it this way to work 
with other vendors' debuggers. Any 
debugger that triggers on the nonmask¬ 
able interrupt can be triggered by 
STATI’s remote breakout switch; the 
user does not have to run any software 
to enable the switch beforehand. 

The switch itself has a bit of a 
mushy feel. It would be nice if the 
switch had some kind of click action to 
let you know that you had triggered it. 
I don’t think I'm being too picky here. 
When you are debugging a program 
designed to test yet another program, 
you don’t want to have to ask yourself 
’’Did I really push that thing, or is my 
software still messed up?” 

The current STATI software does not support the use of 
more than one STAT! board in the computer. That seems like 
a shame to me, because with one board you are stuck with 
using one interrupt line, not counting the NMI. Alpha Logic 
says you can put more than one board in the computer at 
the same time, and you can probably even make the 
software work by addressing only one board at a time, but 
they have not tested the software with more than one board. 

The current STAT! software cannot be used with Windows 
applications. Alpha Logic says they are developing a software 
product (VSTAT!) to provide “virtual timers” with this board, 
which should be out by the time you read this. 

Conclusion 

The STAT! timer board and object library can be a very 
useful tool for realtime programmers working in C, C++, or as¬ 
sembly language. It offers developers a way to perform timing 
tests on their code without interfering with the computer’s 
native timing hardware. It also provides a lot more resolution 
and accuracy than the computer's hardware. 

STAT! is simple, yet versatile. It is easy to program, and 
since the assembler source code is provided with the product, 
it is easy to customize. Where the product is lacking is mainly 
in software and documentation - there is no support for mul¬ 
tiple boards, it won’t do Windows, and it is easy for inex¬ 
perienced hardware programmers to misuse. If you are a real¬ 
time programmer, I think STAT! is worth your consideration. □ 
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Tech Tips 



Edited by 
Leor Zolman 


Please send us your best 
tricks and hacks — those 
clever pieces of code to 
make things work the way 
they should! You’ll receive 
at least $50 for each tip 
that we print. 

Send your submissions to.- 
Tech Tips 
Leor Zolman 

1601 W. 23rd St, Suite 200 
Lawrence, KS 66046-2743 
or email 

techtips@rdpub.com. 


Clean Your Disks! 


Philip j. Erdelsky 
4092 Ohio Street 
San Diego, CA 92104 


By now, everybody who uses a PC should know that when you use DOS to erase 
a file, it really isn't erased until by chance some other file is written on top of it. It 
just becomes a little hard to find. A lot of old information, including confidential 
payroll information, proprietary designs, old love letters, etc., may still be there in 
the so-called “unused data space” of your disk, waiting for some snoop with a file 
recovery package to find it. 

There's a very simple way to get rid of the information in old erased files. You 
don't need a commercial file utility package. Just write a big file containing worthless 
data until you run out of disk space. Then delete the file. That's just what 
cleandsk.c (Listing 1) does. The file it writes is named cleandsk.$$$. If that name 
conflicts with another on your disk, just change it. 

Compile the source code file cleandsk.c with Turbo C 2.0 (or a compatible later 
version). The Tiny memory model will do. Then type 

CLEANDSK [drive-letter] 

If you omit the drive letter, the current drive is used. 

While writing the file cleandsk.$$$, the program will show you a countdown to 
keep you amused. If you want to abort the cleanup, just type Ctrl-C and delete 
cleandsk.$$$. 

The cleanup may seem slow, but it actually goes quite fast. Experiment has 
shown that cleaning a 360Kb diskette with no files on it takes no longer than for¬ 
matting it, even with a high-speed format utility that doesn't do any verification. The 
program will fail gracefully if there is no room for the file cleandsk.$$$ in the root 
directory, or if the file already exists but is read-only. 

The buffer from which cleandsk.$$$ is written is cleared to zeros by the C setup. 
You might prefer to fill it with something more meaningful but equally worthless. 

If there are any disks you think you ought to clean using Mr. Erdelsky's pro¬ 
gram, do it soon; in the next edition of Tech Tips, we’li present a related tip by Mr. 
Erdelsky that shows a simple way to peek into a disk’s unused data space without 
having to resort to a commercial file recovery package... -\z 



Leor Zolman has been involved with microcomputer programming for 15 gears. He is 
the author of BDS C, the first C compiler targeted exclusively for personal computers. 
Leor's first book, Illustrated C, is now available from R6tD Publications, Inc. Leor and 
his family live in Lowrence, KS. 


















A Universal EXE-to-BIN Conversion Utility 


James K. Lawless 
1622 Ave F 
Council Bluffs, IA 51501 
(712)-323-6569 

I happened upon a letter in an older issue of Windows/DOS 
(back when the journal was named TECH Specialist) that refer¬ 
enced the mysterious exe2bin.com program. 

My needs required that I have a version of exe2bin.com 
that was not specific to a particular version of DOS. At the 
time, I simply chose a version of exe2bin and patched the 
DOS-version check in the code. 

After researching the internals of the exe file format, I 
found that in all cases the binary module that is produced by 
exe2bin is at the tail-end of the exe file. The trick is to locate 
the module's starting position within the exe file. 



exetobin.c (Listing 2) is my solution to this small problem. 
After it validates a few things in the header, it writes the bi¬ 
nary module out. 

I've tested this program with DOS device drivers and COM 
file programs. 



Waiting for Midnight 
(Vipers and Vampires Return from the Dead!) 


Murray L. Lesser 
2474 Hunter Brook Rd; 
Yorktown Hts, NY 10598 
914/739-5587 


In November, 1991, you published an essay by Philip J. Er- 
delsky in which (amongst other things) he discussed the prob¬ 
lem of getting both the date and time for the same day, if the 
two calls were made around PC midnight. I sent a C-language 
"solution’’ to the problem, reading the CLOCKS driver directly, 


Listing 1 (cleandsk.c) 


/* 

* clean the erased data area of a disk - Philip J. Erdelsky 
*/ 

Idefine BUFFER_SIZE 16*1024 

finclude <stdio.h> 
linclude <dos.h> 
linclude <io.h> 


□ Use with Visual Basic, C/C++, TPW, etc... 

□ Animate sprites on a colored background within a window. 

□ Great for games, education, multimedia. 

□ Algorithmic or bitmap sprites. Or a combination of both. 

□ Change sprite display priority on the fly. 

□ Background scroll and collision detection. 

□ Maintain multiple animation zones within a window. 

□ Easy to understand user manual. 

□ WANIM.DLL is only $69. With source $99. $5 S&H. 

□ No Royalties. Call or write for free demo disk and info. 


AND-XOR Systems 

1107 Fair Oaks Ave., Suite 167 
South Pasadena, CA 91030 
(213)969-4081 Voice 
(213)256-3271 Fax 
□ Request 128 on Reader Service Card □ 
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static void error_exit(char *s) ( fputs(s, stderr); exit(l); } 

void main(unsigned arge, char **argv) 

( 

static char FILESPEC[] = “X:\\CLEANDSK.$$$"; 

char *filespec; 

unsigned long free_bytes; 

int drive, handle; 

static char buffer[BUFFER_SIZE]; 

struct dfree d; 

if (arge < 2) 

I 

drive * 0; 

filespec = FILESPEC+2; 

} 

el se 

( 

FILESPEC[0] = argv[l][0] & OxDF; 
drive = FILESPECfO] - ('A'-l); 
filespec - FILESPEC; 

) 

printf("Writing %s\n“, filespec); 
handle * _creat(filespec, 0); 
if (handle < 0) 

error_exit("File creation errorW); 

getdfree(drive, &d); 
if (d.df_sclus == OxFFFF) 

error_exit("Disk errorW); 
free_bytes = 

(unsigned long )(d.df_bsec * d.df_sclus) * d.df_avail; 
printf(“%1d free bytes to be cleaned\n", free_bytes); 

while (free_bytes > 0) 

( 

unsigned size ■ 

free_bytes < BUFFER.SIZE ? free_bytes ; BUFFERJIZE; 

if (_write(handle, buffer, size) < size) 
error_exit("\nFile write errorW); 
free_bytes -- size; 
printf("%llld\r", free bytes); 

} 

if (_close(handle)) 

error_exit("\nFile write errorW); 

unlink(filespec); 
puts("\r0one "); 

exit(0); 

) 

/* End of File */ 


* > 

Easy Sprite Animation 

for MS Windows 

WANIM.DLL makes it easy to incorporate 
video game animation into your own 
Windows programs. 
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which you published in May, 1992. However, yesterday (July 
10, 1992) you (Leor) sent me a copy of an assembled version 
of my solution written by John Mourias of Chicago. The as¬ 
sembled version blew up, scattering unwanted debris else¬ 
where in the heap. 

I tested Mr. Mourias’ program by rewriting it for a different 
memory model and assembling it with a different assembler, 
with no change in the unhappy results. Further testing of my 


published C version, and of a compiled BASIC version, showed 
that while these “standalone" tests of opening and reading the 
CLOCKS device apparently worked as advertised, doing so 
threw unwanted bytes elsewhere into heap space — some¬ 
times with "unpredictable results" when contained in a larger 
program. Thus, my published "solution” to Mr. Erdelsky's prob¬ 
lem was a disaster. Sorry about that, chief. 


Listing 2 (exetobin.c) 


/* James K. Lawless 

* DOS-version independent EXE to BIN converter 

* This program may be used freely. 

*/ 


/* Fail if EXE has a stack */ 
if((ehdr.stack_disp!=0)||(ehdr.SP_reg!=0)) { 
fprintf(stderr,“Module has a stack\n"); 
exit(l); 


linclude <stdio.h> 

typedef unsigned int WORD; 
main(int argc.char **argv) 
{ 


FILE *fp 
struct ( 

,*fout; 

char 

sig[ 2 ]; 

WORD 

remainder; 

WORD 

pages; 

WORD 

relo items; 

WORD 

hdr_size; 

WORD 

min_alloc; 

WORD 

max alloc; 

WORD 

stack_disp; 

WORD 

SP reg; 

WORD 

checksum; 

WORD 

IP_reg; 

WORD 

CS_disp; 

WORD 

relo_disp; 

WORD 
) ehdr; 

ovl number; 


long header_size,prg_size,l; 
static char buff[512]; 

if(argc<3) { 

fprintf(stderr,"SYNTAX;\n" 

“%s <infi1e.EXE> <outfile.ext>\n", 
argv[0]); 
exit(l); 

1 


/* IP must be either lOOh or Oh */ 
if( (ehdr.IP_reg!=0xl00) && (ehdr.IP_reg!=0)) { 
fprintf(stderr,"Invalid IP value %x\n", 
ehdr.IP_reg); 
exit(l); 

} 

/* Module must not have relocatable references */ 
if(ehdr.relo_iterns) ( 
fprintf(stderr, 

"Module has %u relocatable items\n", 
ehdr.relo_item$); 
exit(l); 

) 


/* Overlay number must be 0 */ 



simple 

multitasking 

executive 



FULL FEATURED KERNEL 

□ task manager □ memory manager 

□ intertask comm. □ error manager 

□ i/o, events, & timing □ resource manager 

□ preemptive □ ROM’able 


if ((fp=fopen(argv[l] ."rb' 1 ))—NULL) { 
fprintf(stderr, 

"Cannot open input file %s\n",argv[1]); 
exit(l); 


if((fout= : fopen(argv[2] ,"wb"))==NULL) ( 
fprintf(stderr, 

"Cannot open output file %s\n",argv[2]); 
exit(l); 


if(!fread(&ehdr,$izeof(ehdr),l,fp)) ( 
fprintf(stderr,"Cannot read header\n"); 
exit(l); 


EASY TO USE 

□ libraries for Microsoft C/C++ and BASIC, 

Borland C/C++, and assembler 

□ Quick Start, User’s Guide, and Reference 

manuals 

□ standalone, PC, and DOS platforms 

□ smxProbe task debugger 

□ 6 months free support and updates 

FAST & SMALL 

□ 15 usee max. interrupt latency 

□ 150 usee typical task switch 

□ 8 to 25 KB code size 


/* First two chars must be "MZ" */ 
if ((ehdr.sig[0]! = ’M 1 ) 11 (ehdr.sig[1]! = 1 Z')) { 
fprintf(stderr,"Invalid .EXE signature\n"); 
exit(l); 


Ask about our $ 95 evaluation kit. 


MICRO ifJ DIGITAL 

6402 ■ Tulagi St. 

Cypress CA 90630-5630 


Call for information: 
1-800-366-2491 

FAX 714-891-2363 
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Listing 2 

-Cont’d 

if(ehdr.ov1 number!=0) { 

exit(l); 

fprintf(stderr,"Invalid overlay number %u\n", 

) 

ehdr.ovl number); 

if(!fwrite(buff,512,l,fout)) { 

exit(l); 

fprintf(stderr,"Write error\n”); 

} 

exit(l); 

\ 

/* Compute the size and offset of the program */ 

) 

header size=(long) ehdr.hdr size; 

if(prg size%512L) ( 

header size«=4; 

if(!fread(buff,(int) prg size%512L,l,fp)) ( 

prg size=(long) ehdr.pages-1; 

fprintf(stderr,"Unexpected E0F\n"); 

prg size*=512L; 

exit(l); 

prg size+=ehdr.remainder; 

} 

prg size-=header size; 

if(!fwrite(buff,prg size%512L,l,fout)) { 

prg size-=ehdr.IP reg; 

fprintf(stderr,"Write error\n"); 

/* seek the block that is our BIN module */ 

exit(l); 

} 

rewind(fp); 

1 

fseek(fp,header size+(long) ehdr.IP reg,SEEK SET); 

fclose(fp); 

for(l=0L; l+512<prg size; 1+=512L) ( 

fclose(fout); 
exit(0); 

if(Ifread(buff,512,1,fp)) ( 

} 

fprintf(stderr,"Unexpected E0F\n“); 

t* End of File */ 


However, an old engineering (and programming) adage 
says “There is more than one way to skin a cat.” The new 
skinning is an assembled procedure that waits until after PC 
midnight if called within four BlOS-clock “ticks” (about a 
quarter-second) before midnight. Calling midwait just before 
requesting time and date will prevent a midnight split. The 
version shown in Listing 3 is written to be linked to compiled 


SuperSound 

LOW -COST, ^SY ^WORK IN EXTENDED DOS TOO! 

Digital Audio Authoring 
Workstations/ 



Tools, > 100 KHz 
■ s Sampling Rate 


GUI Editors $19 to $149 


Stereo / Mono Hardware and 
Software Kits - only $254 / $179 


Developers for Windows 3.0 / DOS 
Create Sounds for SoundBlaster, Covox, 
Disney; Import Mac, Amiga Sounds... 

DLLs, C, Turbo C, C + +, Visual Basic, Quick Basic Tools 
Data Compression / Decompression of 8:6, 8:4, 8:2, 8:1... 


IBM-PC DIGITAL VOICE / SOUND 

from only $20 Printer Port Audio D/A $218-$629 hw/s^ 

Pro Quality Software / Hardware 
- in use worldwide, even Japan! 

30 Day Money-Back Guarantee if not Satisfied 
. JUST LIKE HAVING A CASSETTE TAPE RECORDER IN A PC. 

• Fastest, easiest Editors with the most features for the price. 

• Quick, simple hardware / software installation. 

• Use for Foreign Language training / communications. 

• For Business: Training, Slide Shows - with Grasp, ShowPartner F/X, and others. 

• For Engineering: Function Generators, Clear Voice Alarms, Storage Scope... 

• Complete Technical Support: Help on Digital Audio HW/SW - no extra charge. 

by Silicon Shack Ph:408-446-4521 FAX: 408-446-5196 

4760 Castlewood Drive, San Jose, CA 95129. 


Technical Info./Orders: 800-969-4411 

Ask for FREE PRODUCT CATALOG. 

In Far East: Bayware Japan, Inc. Tel:(03)972-5391 FAX: (03)959-1214 

OEM Developers: Add QUALITY audio hardware to your product 

" SuperSound, SoundFX, SoundCard are trademarks of Silicon Shack, Ltd. Other product names are trademarks of their manufacturers. 

□ Request 102 on Reader Service Card □ 


BASIC programs, but can easily be edited for other high-level 
languages. Listing 4 is a compiled BASIC test driver. Figure 1 
shows the results of running testwait.exe after resetting the 
DOS clock to 23:59:59.75, using a batch file. (If you are running 
under DOS 3.3, or later, and haven't cut the unholy tie be¬ 
tween the DOS clock and the real-time clock, you will have to 
reset your real-time clock after trying this one.) 

Hope this is helpful. 

More on Copying Large Data Chunks in C 


James K. Lawless 
1622 Ave F 
Council Bluffs, IA 51501 
and 

Roger Samaan 
15519 Howard Circle 
Omaha, NE 68154 

In the June issue of Windows/DOS Developer's Journal, 
Professor Berthold Horn presents code to move data from a 
near buffer to a huge buffer using an intermediate far pointer 
for improved program efficiency. The code presented and its 
purpose are confusing. 

Horn's hmemcopyO function accepts an unsigned long as 
the number of bytes to move, but a near buffer can hold at 
most 64Kb! 

If Professor Horn desires to copy 64Kb from a near buffer 
to a specific spot in a huge buffer, he should dig a little 
deeper into the 80x86 real-mode addressing scheme. He 
should also look for the documentation on the Microsoft C 
_fmemcpy() function. 

A huge pointer's offset address can be normalized to the 
range of 0 to 15 inclusive by stripping the upper 12 bits off 
and adding them to the segment address (e.g., the address 
2938:4657 becomes 2D9D:0007). After normalizing, the pointer 
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Listing 3 (midwait.asm) 

•model medium 

; MIDWAIT.ASM - An assembled procedure to be linked to 
; compiled BASIC programs [DECLARE SUB MIDWAIT ()]. MIDWAIT 
; waits until midnight if called within the last four BIOS 
; "ticks" before midnight. 

; Written by Murray L. Lesser, 7/11/92 

• code 


public 

midwait proc 

midwait 


mov 

bx,6ch 


around: mov 

ax,40h 


mov 

es,ax 


les 

dx.es:[bx] 

;Read BIOS timer count 

mov 

ax,es 


cmp 

ax,18h 

; (Timer resets when the 

jne 

done 

; count would be 1800b0h) 

cmp 

dx.Oach 

jStarting at "midnight" - 4 

jnb 

done: ret 

midwait endp 
ret 
end 

around 

;Spin until midnight 


; End of File 


Figure 1 

F:\>time 

Current time is 10:28:54.46a 
Enter new time: 23:59:59.71 

F:\>testwait 

86399.72 

0 

F:\> 


can then be referenced as far instead of huge. The following 
macro will normalize a far pointer: 

#define NORMALIZE(x) (void far *) (long) (((((long) 
(FP_SEG(x) + \ 

(FP_0FF(x)»4))) )«16L) | (FP_OFF(x)&OxOf)) 

The _fmemcpy() function takes two far pointers as destination 
and source addresses regardless of the memory model used. 
If the _fmemcpy() function is properly prototyped (by including 
memory, h) a near pointer will be properly converted to a far 
pointer when the function is called. Professor Horn's bmem- 
copy() function could then be replaced with: 

_fmemcpy(NORMALIZE(huge_ptr),near_ptr,bytes_to_move); 

Note that this technique will reliably copy 65,520 bytes of 
memory since the offset address can have a maximum value 
of 15. 

To accomplish a similar task in Windows 386 enhanced 
mode, a few WINMEM32 functions must be used since selec¬ 
tors cannot readily be translated into a physical address the 
way that segments can. The Global32Alloc() function allo¬ 
cates a huge buffer with a single selector pointing to it (16:32 
selector). Since Windows functions can deal with 16:16 selec¬ 
tors only, the program must call Globall6PointerAlloc(), 
which creates a 16:16 pointer alias for up to 64Kb bytes 


Listing 4 (testwait.bas) 

.model medium 

; MIDWAIT.ASM - An assembled procedure to be linked to 
; compiled BASIC programs [DECLARE SUB MIDWAIT ()]. MIDWAIT 
; waits until midnight if called within the last four BIOS 
; “ticks" before midnight. 

; Written by Murray L. Lesser, 7/11/92 

• code 


public 

midwait 


midwait proc 



mov 

bx,6ch 


around: mov 

ax,40h 


mov 

es,ax 


les 

dx,es:[bx] 

;Read BIOS timer count 

mov 

ax,es 


cmp 

ax,18h 

; (Timer resets when the 

jne 

done 

; count would be 1800b0h) 

cmp 

dx,0ach 

jStarting at "midnight" - 4 

jnb 

around 

;Spin until midnight 

done: ret 



midwait endp 



ret 



end 



; End of File 




region of the huge buffer pointed to by the 16:32 selector, 
given a long offset into that buffer. The alias can be refer¬ 
enced with an offset in the range 0 to 65,535 inclusive and 
can be passed to any function that expects a far pointer. The 
pointer should be freed when no longer needed with the 
Globall6PointerFree() function. Note that you must use 
winmem32.dll to provide that functionality. 

We hope that this clears things up a bit. □ 


IT WORKS!! 


Does this describe your product? 
Then try our ads-they also work. 
Every month over 18,000 
Windows and DOS developers 
use our ads to locate and buy 
products. Shouldn’t vour product 
be here? 

Call us today for a free 
media kit. Put 

Windows/DOS 
Developer’s Journal 

to work for y ou. 

Windows/DOS 
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■ Windows Questions and Answers 



Q ln the May 1992 issue, you received a question from Shuchi Grover concerning 
aligning entries in a ListBox. You chose to answer that creating a fixed pitch 
font is simple and straightforward. While this does the job, there are several disad¬ 
vantages to this approach, and a much more elegant way of accomplishing this task. 

The disadvantages, to start, are that a fixed font in an otherwise proportional font 
Windows world will look very much out of place. Second, the overhead of Create- 
Font() is unnecessary since the system fixed font would also work wonderfully and 
could be loaded by calling 

hFont = GetStockObject(SYSTEM_FIXED_FONT); 

Third, CreateFont() does not have a simple parameter list, and the entire issue 
of fonts and font selection is a difficult one to master. And last, since every entry in 
a ListBox uses space in the default data segment, the additional space padding was¬ 
tes precious space. 

The elegant solution would be to create the ListBox using the LBS_USETABSTOPS 
style and use the LB_SETTABSTOPS message to set the appropriate tab stops for 
columned entries in the ListBox. The strings to be added should have their fields 
separated by a tab character ("\t") which is interpreted during the LB_ADDSTRING 
message. This method guarantees alignment so long as each tab stop is set past the 
longest entry for that column. The tab stop positions themselves can be set using 
the following calculation: 

nTabStop[i] = (int)(LOWORD( GetDialogBaseUnits()) * ColPosition * 2) / 4; 


Paul Bonneau 


Send questions to Paul via Internet 
as bonneau@hyper.hyper.com-, 
from CompuServe: 
>INTERNET:bonneau@hyper. hyper, com-, 
or in care of this magazine at: 

1601 W. 23rd St„ Suite 200 
Lawrence, KS 66046-2743. 
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Suppose we want the output to look like this: 

Namel Addressl Cityl Statel Zipl 

Name2 Address2 City2 State2 Zip2 

etc... 

where “Name” begins in the first column, “Address” in column 
16, “City" in column 32, “State" in column 48, and "Zip" in 
column 56. 

The code in Listing 1 for the WM_INITDIALOG message 
would accomplish this. Again, to guarantee that the alignment 
is preserved, you need only ensure that the text extent of 
szName is never greater than the first tab stop position, that 
the text extent of szAddr is never greater than the second tab 
stop position, etc. For simplicity's sake, you can use the length 
of szName rather than its text extent. 

Steven Katz 
Steve Hoang 
Micro Product Development 
CCH Computax 
Torrance, California 

A Good points. Windows is so rich that there are usually 
several ways to implement any given piece of 
functionality. Personally, I am so used to calling CreateFont() 
that I tend to forget that Windows provides the default sys¬ 
tem font via GetStockObject(). 

In your last point you mention that space for the list is 
allocated out of the default data segment. Microsoft has fixed 
this problem in version 3.1. ListBoxes now store their entries 


in a global block of memory, allocated when the ListBox win¬ 
dow is created. Also, there is really no need to call Get- 
DialogBaseUnits() to determine the tab stops. 

The LB_SETTABSTOP message accepts an array of tab stops 
expressed in dialog units, which by definition are 1/4 the 
width of an “average” character in the system font. So, if you 
want a tab stop at the 16th character position, just multiply 
this value by 4 to convert to dialog units. GetDialogBase- 
Units() returns the width and height of an “average” charac¬ 
ter in the system font in pixels. Dividing the horizontal 
measure by 4 gives the number of pixels per horizontal dialog 
unit. On a VGA, GetDialogBaseUnits() will return 8 for the 
horizontal measurement. Using your calculation, multiplying 
by 2 and dividing by 4 just happens to equal 4, the number of 
dialog units per character. But in general, this formula will not 
supply the required value. Instead use: 

nTabStop[i] = ColPosition * 4; 

Thanks for the feedback! 

Q l need to be able to handle right clicks on the menu bar. 

What I need is to get the handle to the popup menu 
the user has right-clicked on without highlighting the menu 
bar and without popping down the menu. As far as I know, 
there are no API calls to do this sort of thing. Furthermore, it 
seems that the only way that a program can get a handle to 
a menu that a user has clicked is after Windows has painted 
(e.g., highlighted and popped down the menu), which is too 
late for my purposes. 


Paul Bonn eau is the senior software design engineer for Hgpercube, Inc., #7-419 Phillip St., Waterloo, Ontario, Canada, N2L 3X2. His 
current project is HyperChem, a molecular modelling software package for Windows. Paul has been developing Windows applica¬ 
tions for 5 gears. Much of his expertise was gained at Microsoft, where he implemented a library module used by all of Microsoft's 
major Windows applications. 




Listing 1 

int nTabStops[4]; 

char szAddString[80]; 

case WMJNITDIALOG: 

nTabStops[0] * (int) 

(LOWORD(GetDialogBasellnits()) * 16 * 2) / 4; 
nTabStops[l] - (int) 

(LOWORD (GetDi al ogBasellni ts ()) * 32 * 2) / 4; 
nTabStops[2] = (int) 

(LOWORD (GetDi al ogBasellni ts ()) * 48 * 2) / 4; 
nTabStops[3] ■ (int) 

(LOWORD (GetDi al ogBasellni ts ()) * 56 * 2) / 4; 

SendMessage(hWndListBox, LB_SETTABSTOPS, 4, 
(LONG)(LPINT)nTabStops); 

memset(szAddString, '\0', sizeof (szAddString)); 
strcpy(szAddString, szName); 
strcat(szAddString, "\t“); 
strcat(szAddString, szAddr); 
strcat(szAddString, "\t“); 
strcat(szAddString, szCity); 
strcat(szAddString, "\t"); 
strcat(szAddString, szState); 
strcat(szAddString, “\t“); 
strcat(szAddString, szZip); 

SendMessage(hWndListBox, LB_ADDSTRING, 0, 

(LONG)(LPSTR)szAddString); 

/* End of File */ 


DISASSEMBLERS 

Recover your source code from compiled 
applications with the following programs: 


Valkyrie, by Code Works, for Clipper S'87. 

$345.00 

OutFoxPro for unencrypted FoxPro 1.x. .. 

$149.95 

OutFoxPro2 for unencrypted FoxPro 2. 

$149.95 

OutFOX for unencrypted FoxBASE-P. 

$149.95 

UEFOX-P unencrypts encrypted FoxBASE-P. 

$395.00 

deFOX for the early FoxBASE 11. 

$149.95 

dCRYPTR for AT dRASE ID+ RunTime-P 

.$149.95 

DECODE for AT dBASE II RunTime. 

.$149.95 


HILCO Software 


11266 Barnett Valley Road 
Sebastopol, CA 95472-9255 


Monday thru Friday 


(707) 829-5011 


8 am to 5 pm Pacific 


Add $Sj 00 shipping and handling for each order. 

Overseas airmail add $5j00 for each program ordered 
California residents add 7.5% sales tax. VISA & Mastercard accepted. 
PO from government agencies and D&B 1 or 2. 


So I have to fool Windows. I thought I could solve the non¬ 
painting of the menu and still get my handle by having an 
off-screen window with the exact same menubar as the win¬ 
dow being displayed (I know the handle I would get to the 
off-screen menu is different then the handle to the menu on 
screen, but it is enough for the computation I need). When 
the user right-clicks on the menu bar of the window showing, 
Windows sends me a UM_NCRBUTT0ND0UN, which I then process 
by sending a MM_NCLBUTTONDOMN message to the off-screen 
window with the same parameters, with the idea that this 
window will process the WM_NCLBUTT0ND0UN by doing its nor¬ 
mal thing of highlighting and popping down the menu, after 
which I could use normal API calls to get my handle. This 
would be OK since the user never sees this happening. As you 
have probably guessed, the menu of the window off-screen is 
not popping down. 

Is it possible to do this, and if so can you show me how? If 
it is not possible to do it this way, can you explain why? Final¬ 
ly, are there alternatives to the above, and if so, can you 
show me how? 

Thanks, 

Ivan Figueredo 
CIS 75460,2417 

A Well, you were pretty close. After doing some poking 
around with the debugger, I found that not only do you 
need to transform the UM_NCRBUTT0ND0UN into a UM_NCLBUT- 
T0ND0WN, but you also have to trick Windows into thinking the 
left mouse button is down. The problem is that after receiving 
the UM_NCLBUTT0ND0WN message, Windows enters a modal 
loop inside the menu manager. Code in the menu manager 
calls GetKeyState (VK_LBUTT0N) to see if the left mouse button 
is down. If it is not, the menu manager returns without fur¬ 
ther processing. 

Fortunately, Windows isn’t very hard to trick. Inside the 
message loop of your application, you can test for WM_NCRBUT- 
T0ND0WN messages for your main window. If you get one, the 
next task is to process only those that have occurred inside 
the menu bar —and this is what the UM_NCHITTEST message 
was designed for. Upon receiving this message, DefWindow- 
Proc() will return a value indicating which part of a level win¬ 
dow is under the point contained in IParam. So, right there in 
the loop, call DefUindowProcf) with the IParam supplied with 
the WM_NCRBUTT0ND0WN message; if it returns HTMENU, the click 
occurred in the menu bar. 

If all these conditions have been met, change the message 
field of your message struct from WM_NCRBUTTONDOWN to 
HM_NCLBUTT0ND0UN, and use SetKeyboardState() to tell Win¬ 
dows to set its internal keyboard map to look like the left 
mouse button is down. This is best accomplished by first get¬ 
ting the state with GetKeyboardState() , then changing the 
entry indexed by VK_LBUTTON to be in the down state (0x80), 
then passing the array to SetKeyboardState(). Now when 
the message is dispatched to your main window (via 
DispatchMessageO), Windows will enter menu mode when 
your main window procedure calls DefUindowProc() with the 
UM_NCLBUTT0ND0WN message. 

The menu manager will now highlight the menu item and 
attempt to drop down the associated popup menu if one ex¬ 
ists. Before the menu is popped up, the menu manager will 
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send your main window a WM_MENUSELECT message which 
will contain the handle of the associated popup window in 
the w Pa ram. At this point, if you post a UM_NCLBUTTONUP mes¬ 
sage to the main window and unset the VK_LBUTTON state in 
the keyboard map, the menu manager will exit menu mode 


without popping down the menu. There will be a brief flash as 
the menu item’s highlight is removed, but at least you now 
have the popup menu handle, as required. If you need to 
suppress the flash, then your two-menu-bar scheme might be 
worth a try. 


Listing 2 (rmenu.c) 


/*****************************************************/ 
/* -- Demonstration of how to right mouse activate */ 
/* of menu items on a menu bar. */ 

^*****************************************************j 

♦include <windows.h> 

VOID SetKey(int, BOOL); 

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM); 

int PASCAL 

WinMain(HINSTANCE hins, HINSTANCE hinsPrev, 

LPSTR IpszCmdLine, int wShow) 

j*****************************************************J 

/* -- Entry point. */ 

j*****************************************************J 

{ 

MSG msg; 

HWND hwnd; 

if (hinsPrev == NULL) 

{ 

WNDCLASS wcs; 

/* Register the main window's class. */ 

wcs.style = 0; 

wcs.lpfnWndProc = WndProc; 

wcs.cbClsExtra - 0; 

wcs.cbWndExtra = 0; 

wcs.hlnstance * hins; 

wcs.hlcon = NULL; 

wcs.hCursor » LoadCursor(NULL, IDC_ARR0W); 
wcs.hbrBackground = 

(HBRUSH)(C0L0R_APPW0RKSPACE + 1); 
wcs.lpszMenuName = "RMenu"; 
wcs.lpszClassName = "RMenu"; 
if (!RegisterClass(&wcs)) 
return 0; 

) 

if ((hwnd = CreateWindow("RMenu", 

"Right menu demo", WS_OVERLAPPEDWINDOW, 
CWJJSEDEFAULT, 0, CW_USEDEFAULT, 0, NULL, NULL, 
hins, NULL)) == NULL) 
return 0; 

ShowWindow(hwnd, wShow); 

UpdateWindow(hwnd); 

while (GetMessage(&msg, NULL, 0, 0)) 

{ 

/* Right button in menu bar? */ 
if (msg.message == WM_NCRBUTT0ND0WN && 
msg.hwnd ■« hwnd && 

DefWindowProc(hwnd, WMJCHITTEST, 0, 
msg.1Param) == HTMENU) 

( 

/* Pretend its the left. */ 
SetKey(VK_LBUTTON, TRUE); 
msg.message = WM_NCLBUTT0N00WN; 


TranslateMessage(Kmsg); 
DispatchMessage(&msg); 

} 

return 0; 


LRESULT CALLBACK 
WndProc(HWND hwnd, 
LPARAM 1Param) 


UINT wm, WPARAM wParam, 


J*****************************************************j 

/* -- Frame window proc. */ 

J*****************************************************J 

{ 

switch (wm) 

{ 

default: 

return DefWindowProc(hwnd, wm, wParam, IParam); 
break; 

case WM_DESTROY: 

PostQuitMessage(O); 
break; 

case WM_M£NUSELECT: 

if (GetKeyState(VK_RBUTT0N) < 0 && 

GetKeyState(VK_LBUTT0N) < 0) 

{ 

/* Undo the left button kludge. */ 

SetKey(VK_LBUTT0N, FALSE); 

PostMessage(hwnd, WM_LBUTT0NUP, 0, 0L); 

if (wParam != NULL) 

PostMessage(hwnd, WM_USER, wParam, 0); 

) 

break; 


C ano C++ DOCUMENTATION 


C-METRir (# 9 ) COMPLEXITY /QUALITY 

• Calculates cyclomatic path complexity for functions ana 


'cyclomatic" path complexity 1 

• Counts lines with comments, code, and 'C statements 


system 


filel 

main 

file2 

—sub2 

file2 

1—sub3 

file2 

1—sub4 

filel 

— main (recursv) 


— Ibryl, Ibry2 


C-CALL m ($69) FUNCTION HIERARCHY 


■ Tree-Diagram showing function hierarchy 

■ Table-Of-Contents of functions versus files 

■ Summary and detailed cross-reference of functions 


C-CMT ($69) FUNCTION COMMENT 

• Generates and inserts function comment blocks 

• Can be re-run to update the comment blocks 

• Retains any user-generated comments 


while (i<j) 

if(i<k) { 
| i-k; 


rFF************************* 
sub2 USERS: main 

CALLS: sub3 sub4 
PARAM: argl arg2 
LOCAL: varl 
GLOBL: var2 var3 
ZJm 


break; 

} 


exit (O); 


C-LIST t 7$69) LISTS OR REFORMATS 

• Action-Diagrams show logic/control flow 

• Optional line numbers, page numbers, and titles 

• Reformats source to various standardized formats 


C-REF™($59) CROSS-REFERENCES IDENTIFIERS 


■ Local/parameter/global/define summary or cross-reference 
• Produces class-hierarchy tree-diagram for C++ classes 

SPECIAL: ($199) C-DO(f DOS Package ($325 Value) 


• All 5 programs fully integrated as 1 overall C-DOC program 

• Processes multiple directories/files up to 15,000 total lines 

• Unconditional 30-day money-back guarantee of satisfaction 

NEW; C-DO(TProfessional ($299); DOS. OS/2. Windows 

• Processes 150,000 lines, 3-ring binder/case, 2-pass deferred reports 


!! NEW 5.0 !! Point-and-click G.U.I. operation !! 


SOFTWARE BLACKSMITHS INC 


6064 St Ives Way, Mississauga 
ONT Canada L5N-4M1 


Voice/Fax: (4161-858-4466 
Demo/BBS: (416)-858-1916 
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Listing 2 — Cont’d 

case WMJJSER: 

{ 

RECT rect; 
int x, y; 

/* Float a menu in the center of the window. */ 
GetClientRect(hwnd, &rect); 

ClientToScreen(hwnd, (LPPOINT)&rect); 
ClientToScreen(hwnd, (LPPOINT)irect.right); 
x = (rect.left + rect.right) / 2; 
y = (rect.top + rect.bottom) / 2; 
GetWindowRect(GetDesktopWindow(), &rect); 

T rackPopupMenu((HMENU)wParam, 

TPM_CENTERALIGN | TPM_RIGHTBUTTON, 
x, y, 0, hwnd, &rect); 

) 

break; 

) 

return 0; 

1 

VOID 

SetKey(int wKey, BOOL fDown) 

j*****************************************************I 

/* -- Set the given key to the given state. */ 

j**★*★*★★★★★***★**★★**★*★★★★*★****★★***★*★**********★★j 

{ 

BYTE rgb[256]; 

GetKeyboardState(rgb); 
rgb[wKey] * fDown ? 0x80 : 0x00; 
SetKeyboardState(rgb); 

) 

/* End of File */ 



BUILD A MINI-DATABASE 
SYSTEM WITH . . . 


Illustrated 

» C 

Leor Zolman 

CUJ columnist and 
author of BOS C 


Discover the WHY and HOW of application design 
and development in C. Explore the construction of 
several different applications from start to finish. 
Chapter after chapter you’ll develop your skills 
through in-depth tutorial and detailed code. 
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I implemented a little application to demonstrate my idea. 
It has two menus, both containing dummy menu items. When 
the user right-clicks on one, a UM_USER with wParam set to the 
popup menu handle is posted. When the WM_USER is 
received, the application calls TrackPopupMenuO to position 
the popup menu in the middle of the screen. Listings 2 though 


Listing 3 (rmenu.rc) 


I *★*★**★*★★★★***★**★******★***★★*★★★★*★★★★★*★★★★★★*★★* j 

/* — Resource script file for rmenu. */ 

linclude <windows.h> 

/* Menu. */ 

RMenu MENU L0AD0NCALL MOVEABLE DISCARDABLE 
BEGIN 

POPUP "&File" 


BEGIN 

MENUITEM 

“File 

Dummy 

8.1", 

0 

MENUITEM 

“File 

Dummy 

8.2", 

0 

MENUITEM 

END 

"File 

Dummy 

8.3", 

0 


POPUP "&Edit" 


BEGIN 

MENUITEM 

"Edit 

Dummy 

8,1", 

0 

MENUITEM 

"Edit 

Dummy 

8.2", 

0 

MENUITEM 

END 

"Edit 

Dummy 

8,3", 

0 


END 


Listing 4 (rmenu.def) 

;; -- Linker module definition file. ;; 

NAME 

RMenu 

DESCRIPTION 

'Right mouse button menu demo 1 

EXETYPE 

WINDOWS 

STUB 

'WINSTUB.EXE' 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

2048 

STACKSIZE 

8192 

EXPORTS 


WndProc 



Listing 5 (makefile) 

####################################################### 
## makefile ## 

## -- Project file for rmenu program. ## 

####################################################### 
all: rmenu.exe 

rmenu.obj: rmenu.c 

cl -c -AM -G2w -Od -Zdpe -W3 -DSTRICT rmenu.c 

rmenu.exe: rmenu.obj rmenu.def rmenu.rc 

link /N0D/m rmenu,,, libw mlibcew, rmenu.def 
rc rmenu 
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5 are the C code, resource file, linked definition file, and 
makefile, respectively. 

Q Maybe you know a little something about the following: 

What happened to the following two functions in Win¬ 
dows 3.1: 


Do they exist, but somewhere else? Any ideas? 

Blake C. Ramsdell 
blakeOpinpoint.com 
GlobalStream Corporation 
PO Box 887 
Hanover, NH 03755 


BOOL FAR PASCAL SetDeskWal1Paper(LPSTR bitmap_name); 
BOOL FAR PASCAL SetDeskPattern(LPSTR pattern_data); 


Listing 6 


LRESULT CALLBACK 

ButtonFilter(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

I *****************************************************j 

/* -- Display a stop sign icon on the face of a */ 
/* PushButton. */ 

y*****************************************************y 

{ 

static BOOL fDown; /* Track button state. */ 
LRESULT lw; /* This routine's value. */ 

/* Let button's real window proc do its work */ 

/* first. */ 

lw * CallWindowProcflpfnButtonProc, hwnd, wm, 
wParam, IParam); 

switch (wm) 

( 

default: 

break; 

case BM_SETSTATE: 

/* Check to see if the state changed. Do */ 

/* nothing it not to avoid flicker. */ 
if ((IwParam && IfDown) || (wParam && fDown)) 
break; /* No change. */ 

fDown = wParam; /* Remember new state. */ 

/* Fall through. */ 

case WM_PAINT: 

( 

HDC hdc; 

RECT rect; 

int dxDoubleBorder, dyDoubleBorder; 

int dxOffset, dyOffset; 

int dxlcon, dylcon; 

/* Offset icon by 2 border thicknesses if */ 

/* button is pushed down. */ 
dxDoubleBorder » 

2 * GetSystemMetrics(SM_CXBORDER); 
dyDoubleBorder * 

2 * GetSystemMetrics(SM_CYBORDER); 
if (fDown) 

( 

dxOffset = dxDoubleBorder; 
dyOffset * dyDoubleBorder; 

) 

el se 

{ 

dxOffset * dyOffset = 0; 

} 

/* Paint the icon in the center of the */ 

/* button plus offset. */ 
hdc = GetDC(hwnd); 

GetClientRect(hwnd, &rect); 
dxlcon = GetSystemMetrics(SM_CXICON); 
dylcon = GetSystemMetrics(SM_CYICON); 
rect.left = dxOffset + 


(rect.right - rect.left - dxlcon) / 2; 
rect.top * dyOffset + 

(rect.bottom - rect.top - dylcon) / 2, 
Drawlconfhdc, rect.left, rect.top, 
Loadlcon(NULL, (LPCSTR)IDIHAND)); 
if (GetFocus() «« hwnd) 

{ 

rect.right = rect.left + dxlcon; 
rect.bottom ■ rect.top + dylcon; 
InflateRect(&rect, dxDoubleBorder, 
dyDoubleBorder); 

DrawFocusRect(hdc, &rect); 

) 

ReleaseDC(hwnd, hdc); 

} 

break; 

} 

return lw; 

) 

/* End of File */ 


windows/DOS Code Listings 
Available via UUCP! 

The listings for all code in each issue of Win¬ 
dows/DOS Developer’s Journal are now being archived 
in machine-readable form by UUNET Technologies, Inc. 
Each archive file has a pathname of the form 

uunet!~/published/windowsdos/19YY/monYY.zip 

where mon is the first three letters of the month (jan, 
feb, etc.) and YY is the last two digits of the year (e.g., 
92). To uncompress the archives, use unzip filename. 
See the file called filename.txt, included in each ar¬ 
chive, for an explanation of the archive's contents. This 
directory is also accessible via anonymous FTP from 
ftp.uu.net. 

You may download these archive files via uucp 
even if you do not have a UUNET account: have your 
uucp program call 1-900-GOT-SRCS and use the login 
name uucp, no password. Callers will be charged a 
nominal fee for connect time (currently 50 cents per 
minute). The modems are mostly Telebit T3000’s, 
which support most of the faster communication 
protocols. 

Code for each issue is also available on diskette 
from R&D Publications at $5.00 per disk (call 913-841- 
1631 for information). 
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A I have seen this question on the Internet several times 
as well. Microsoft finally decided to sanction these com¬ 
monly used but undocumented functions. The new routine is 
SystemParametersInfo(). It accepts a parameter identifier 
(SPI), a pair of SPI specific values, and a flag that says whether 
or not to update win. ini and whether or not to broadcast a 


UM_UININICHANGE message. SetDeskUallPaperf) is imple¬ 
mented with the SPI_SETDESKWALLPAPER identifier, and Set- 
DeskPattern() is implemented with SPI_SETDESKPATTERN. 
(See pages 927-933 of Programmer Reference, Volume 2: Func¬ 
tions for more information.) 


Listing 7 

.*****************************************************. 

> » 

; — VxD whose only purpose is to detect if the ; 

; system VM has the keyboard focus. ; 

•★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★Hr**# 

» 1 

.386p 

•*★★**★★★★★★★*★★★★*★★★*★*★*★★★★★★****★★*★★★*★★******★★• 

> » 

; Header files. ; 

.*****************************************************. 

» » 

include vmm.inc 
include vkd.inc 

.★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★it**. 

> > 

; Constants. ; 

.*****************************************************. 

; Permanent device id obtained from Microsoft. 
wDeviceld EQU 2953H 

; VxD version number. 
bVersionMajor EQU 01 
bVersionMinor EQU 00 

wVersion EQU (bVersionMajor * 256 + bVersionMinor) 

; API id's. 
apiGetVersion EQU 0 
apiFocusTest EQU 1 

• ***************************************************** • 

; Device Header. ; 

******************************************************* 

» t 

Declare_Virtual_Device wddjkeyf, bVersionMajor, \ 

bVersionMinor, WddjKeyfControl, wDeviceld, \ 

Undefined_Init_Order,, WddjKeyfApi 

•*★*★**★★**★****★**★***★*****★**★★**★**★***★★*★★***★★*• 

» * 

; Control Procedures. ; 

•*********★*******★★★***★*★★******★****★★★★★★★★★**★***• 

» » 

V xD_Loc ked_Code_Seg 

******************************************************* 

1 » 

; — Called for protect mode initialization. Not ; 

; much to do. ; 

******************************************************* 

* * 

BeginProc WddjKeyflnit 

cl c 

ret 

EndProc WddjKeyflnit 

•*****************************************************• 
t » 

; — Control dispatcher. Not much to do here either. ; 

•****************************************************** 

» * 

BeginProc WddjKeyfControl 

Control_Dispatch Device_Init, WddjKeyflnit 

clc 

ret 

EndProc WddjKeyfControl 
VxD_Locked_Code_Ends 

.****************************************************** 

; API's. 

.*****************************************************. 

> » 

VxD_Code_Seg 


(wddjkeyf.asm) 

****************************************************** 

» 

; -- Main dispatch point for protected mode API. 

; -- EAX : API id to execute. 

; -- Jump to corresponding API routine. 

. ***************************************************** 
» 

BeginProc WddjKeyfApi, Public 

; Innocent until proven guilty (no error yet), 
mov [ebp].Client_Flags, 0 

; Which function is required? 
movzx eax, [ebp].Client_AX 

cmp ax, apiGetVersion 

jz short WddjKeyfGetVersion 

cmp ax, apiFocusTest 

jz short WddjKeyfTest 

; Guilty. Set carry flag to indicate failure. 

or [ebp] .Cl ient_Flags, CF_Mask 

ret 

EndProc WddjKeyfApi 

.*************************************'**'************** 

t 

; -- Return the version number. 

.***************************************************** 

( 

BeginProc WddjKeyfGetVersion, Public 
mov [ebp].Client_AX, wVersion 

ret 

EndProc WddjKeyfGetVersion 

****************************************************** 

* 

; -- Test if the system VM has the keyboard focus. 

; -- Returns via DS:AX : 

; -- zero if system VM has keyboard focus, 

; -- handle of VM with keyboard focus otherwise. 

****************************************************** 

> 

BeginProc WddjKeyfTest, Public 

; VM handle of keyboard owner returned in EBX. 

VxDCall VKD_Get_Kbd_Owner 

mov eax, ebx ; Save it away. 

; System VM handle returned in EBX. 

VMMCall Get_Sys_VM_Handle 

cmp eax, ebx ; Same as keyboard owner? 

jz short SysVMHasFocus 

; Return non-system VM owning keyboard. 

mov [ebp].Client_AX, ax 

shr eax, 16 

mov [ebp].Client_DX, ax 

jmp short WddjKeyfTestExit 

SysVMHasFocus: 
xor ax, ax 

mov [ebp].Client_AX, ax 

mov [ebp].Client_DX, ax 

WddjKeyfTestExit: 

ret 

EndProc WddjKeyfTest 

VxD_Code_Ends 

End 

; End of File 
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Q ln the February and March issues, I read the articles 
about custom controls. They look quite interesting. On 
my products, I want to have buttons (push buttons) which 
could have either an icon or a bitmap displayed on them. I 
have the feeling that such buttons could be easier to program 
than a brand new custom control. Is subclassing involved in 
that? I saw some listings on that, but was not too sure about 
how to use those pieces of code. I understood that the units 
of measures inside the dialog editor are not the same as the 
ones used when displaying a bit map. 

Do you have any sample program I could "plug-in” to my 
program listing? 

Jean-Francois Messier 
SuperByte 386 Telecommunications 
HULL, PQ CANADA 

A You're right, subclassing the existing button class is quite 
a bit easier than writing a new control from scratch. 
There is actually a third alternative, using owner-draw but¬ 
tons, but this too involves more work than subclassing. Essen¬ 
tially, you want the push button to do all the work of painting 
itself in either of its two states (up or down). This eliminates 
the need for your code to do the highlighting. By subclassing 


Listing 8 (sysfocus.def) 

;; -- Linear linker definition file for Wddjkeyf ;; 

;; VxD. 



LIBRARY wddjkeyf 


DESCRIPTION 

'System focus detector VxD vl.0 1 

EXETYPE 

DEV386 


SEGMENTS 



LTEXT 

PRELOAD 

NONDISCARDABLE 

LDATA 

PRELOAD 

NONDISCARDABLE 

TEXT 

CLASS 

'PC0DE* NONDISCARDABLE 

_DATA 

CLASS 

1 PC0DE 1 NONDISCARDABLE 

EXPORTS 



wddj keyf_DDB 



Listing 9 (sysfocus.h) 

j★★*★★★★*★***★***★★★★★***★*****★★★***★★★★*★★★*★★******j 

/* -- Interface to Wddjkeyf VxD. */ 

Idefine wWddjkeyfDeviceld 0x2953 

/* Current version of VxD. */ 

Idefine wWddjKeyfVersion 0x0100 

/* API ids. */ 

/* Return VxD version number. */ 

Idefine apiGetVersion 0 

/* Test if system VM has keyboard focus. */ 

Idefine apiFocusTest 1 

/* End of File */ 
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the button, you can let the button's original window proce¬ 
dure handle all painting, and after the original window proce¬ 
dure returns, your subdasser paints its graphic on the 
button's face. 

You will want to create the button with NULL for the text 
field, but this means that the button will not show a caret 
when it receives the focus. The reason is that the caret is 
drawn to just surround the button’s text, so no text, no caret. 
After you have painted your graphic, you should call Get- 
Focus (), and if the button has the focus, use DrawFocus- 
Rect() to draw a caret around the graphic. 

For a push button, two messages are important for repaint¬ 
ing, m_PAlNT (of course) and BM_SETSTATE. The BMSETSTATE 
message is sent each time some part of the button’s state 


Listing 10 (makefile) 

iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii 

II -- Project file for WddjKeyf VxD. II 

llflllflflf#fllllllllflllllfll#llllllllll#lflllll#f|f|| 
all: wddjkeyf.386 

wddjkeyf.386: wddjkeyf.obj wddjkeyf.def 

link386 wddjkeyf.obj.wddjkeyf.386 /N0I /NOD /NOP \ 
/MAP,,,wddjkeyf.def 
addhdr wddjkeyf.386 
mapsym32 wddjkeyf 

wddjkeyf.obj: wddjkeyf.asm 

masm5 -p -w2 -Mx -Zd wddjkeyf; 


CHOICE INSTALL 


Competitive upgrade! Only $49 with proof of 
purchase of another installation program 
through Aug. 30,1992! 


No programming! Run the generator, compile and link, run a 
program to build your disks and you're ready to ship! 90 day 
money back guarantee, no royalties. Fully functional demo 
disk: $5, credited on purchase. Specify disk size (3.5"DD or 
5.25" HD). 


• Automatic detection of system features. 

• Windowed user interface with context-sensitive help. 

• No script language to learn, only one file on disk. 

• Fast file transfers use all available RAM. 

• Uses Microsoft, Borland, Zortech C or C++. 

• Takes less than 100K on one distribution disk. 

• Data compression/expansion built in. 

• Handles files of any size to multiple output paths. 

• Includes object code, object library and partial source. 

• Sophisticated error handling. 

Send $149 plus $5 shipping and handling to: 

ChoiceWare 

8802 East Broadway Suite 211, Tucson, AZ 85710 
Info or orders: (602)298-0666 (Voice or FAX) 

Microsoft, Borland, Zortech are trademarks of their respective companies. 

■ 

□ Request 347 on Reader Service Card □ 

Windows/DOS Developer's Journal — Page 59 


- " ‘ 



















Listing 11 

(testfocs.c) 

/*****************************************************j 

( 

/* -- Test if the system VM (the one that all */ 

xor di, di 

/* Windows apps run in) has the keyboard focus. */ 

mov es, di 

f*****************************************************J 

mov ax, wGetCal1backld 

linclude <windows.h> 

mov bx, wWddjKeyfDeviceld 

linclude "wddjkeyf.h" 

int 0x2f 

mov ib, di 

Idefine wGetCal1backld 0x1684 

mov sb, es 

} 

lpfn = (LPFN VXD API)MAKEL0NG(ib, sb); 
if (lpfn — NULL) 

typedef DWORD (CALLBACK * LPFN_VXD_API)(VOID); 

int 

WDosOwnsKeyboard(VOID) 

return -1; 

!*****************************************************! 

/* Make sure expected version is installed. */ 

/* -- Call the WddjKeyf VxD to see if a DOS box owns */ 

asm mov ax, apiGetVersion; 

/* owns the keyboard. */ 

if ((WORD)(*lpfn) () < wWddjKeyfVersion) 

/* -- Return TRUE if it does, FALSE otherwise. */ 

/* -- Return -1 in case of error. */ 

return -1; 

j*****************************************************j 

I* Call the VxD and find out who owns the */ 

{ 

/* keyboard. */ 

LPFN VXD API lpfn; 

asm mov ax, apiFocusTest; 

int sb, ib; 

return (*1pfn) () != OL; 

} 

/* Get the address of the Wddjkeyf VxD's protect */ 

/* mode API dispatcher. */ 

_asm 

/* End of File */ 


changes, and may cause the button’s original window proce¬ 
dure to redraw the button. The reason I say "may’’ is that this 
message may get sent a lot, sometimes when the state has 
not changed. For example, if you click the button without 
releasing the mouse and move the mouse over the face of 
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the button, a new BM_SETSTATE message will get sent for 
each mouse move. The button's window procedure is smart 
enough to know not to perform a repaint each time, and your 
code should be, too (to avoid unnecessary flicker). 

The sample routine in Listing 6, ButtonFilter() , presents 
a window procedure that can be used to subclass a push but¬ 
ton. It will draw a stopsign icon in the middle of the push 
button. If you want a bitmap, use BitBltf) instead of Draw- 
Icon () to display the bitmap, but the basic idea remains the 
same. You might also want to store the handle of the bitmap 
or icon in a window property, to genericize the routine. 

ButtonFilter() first calls the original window procedure 
to handle all messages. This ensures that the visual state of 
the button’s background is up to date when control returns to 
ButtonFilter(). ButtonFilter() keeps track of the button 
state with a static Boolean. Whenever it receives a 
BM_SETSTATE message, it checks the accompanying wParam to 
see if the state is any different from what's there already. If 
the state has changed, it records the new state and drops into 
the paint code. 

If the button is in the down state, the graphic should be 
shifted a small amount to the bottom right-hand corner to 
emulate the behavior of a standard push button containing 
text. I found that two border thicknesses in each direction 
looks acceptable. 


Listing 12 (testfocs.h) 

I***************************** ************** icicle ******* j 

/* -- Interface to routine to test if system VM has */ 
/* keyboard focus. */ 

f*****************************************************^ 

int WDosOwnsKeyboard(VOID); 

/* End of File */ 
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Listing 13 (killer.c) 


j*****************************************************j 

/* — Program to kill any application possessing a */ 
/* visible window the user can pick with the */ 
/* mouse. */ 

j *****************************************************j 

#include <windows.h> 
linclude "killer.h" 

/* Globals. */ 

HINSTANCE hins; /* Instance of this app. */ 

TIMERPROC IpfnTimer; /* Timer proc instance. */ 

/* Prototypes. */ 

BOOL CALLBACK KillerDlg(HWND, UINT, WPARAM, LPARAM); 
void Ki1lWnd(HWND); 

void CALLBACK TimerProc(HWND, UINT, UINT, DWORD); 
int CALLBACK 

WinMain(HINSTANCE hinsThis, HINSTANCE hinsPrev, 

LPSTR lszCommand, int wShowWindow) 

j*****************************************************j 

/* -- Entry point. */ 

J ************************************ **********★★*★★**j 

{ 

DLGPROC lpfnDialog; 
hins = hinsThis; 


case didPick: 

/* Capture the mouse so that we can */ 

/* click on another app's window and get */ 
/* a message. */ 

SetCapture(hwnd); 

/* Let the user know we are in “pick" */ 

/* mode. */ 

SetCursor(LoadCursor(NULL, IDCJJPARROW)); 
break; 

case didKill: 

if (IsWindow(hwndPick)) 

{ 

/* Do our thing! */ 

SetDlgItemText(hwnd, didWindow, NULL); 
Ki11Wnd(hwndPick); 

) 

break; 

case IDCANCEL: 

/* We will get this when the user picks */ 
/* “Close" on our system menu. */ 
EndDialog(hwnd, FALSE); 
break; 

1 

break; 


t* Create a dialog instead of a main window. */ 

/* No need to register a class this way. */ 
if ((lpfnDialog = (DLGPROC)MakeProcInstance( 
(FARPROC)Ki1lerDlg, hinsThis)) == (DLGPROC)NULL) 
return FALSE; 

DialogBox(hinsThis, "Killer", NULL, lpfnDialog); 

FreeProcInstance((FARPROC)lpfnDialog); 
return TRUE; 

) 


BOOL CALLBACK 

Ki11erDlg(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

^*****************************************************I 

/* -- Dialog proc for killing other apps. */ 

^*****************************************************j 

( 

static HWND hwndPick; 
switch (wm) 

I 

default; 

return FALSE; 

case WMJNITDIALOG: 

( 

RECT rect; 

int dx = GetSystemMetrics(SM_CXSCREEN); 

int dy = GetSystemMetrics(SM_CYSCREEN); 

/* Center the dialog on the screen. */ 

GetWindowRect(hwnd, &rect); 

SetWindowPos(hwnd, NULL, 

(dx - (rect.right - rect.left)) / 2, 

(dy - (rect.bottom - rect.top)) / 2, 

0, 0, SWP_NOSIZE | SWP_N0Z0RDER); 

/* Start with focus on the pick PushButton. */ 
SetFocus(GetDlgItem(hwnd, didPick)); 

) 

return FALSE; 

case WM_COMMAND: 
switch (wParam) 

{ 

default: 

return FALSE; 


case WM_LBUTT0ND0WN: 

{ 

POINT pt; 
char szBuf[10]; 

if (GetCapture() != hwnd) 

return FALSE; /* Wasn't in pick mode. */ 
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Listing 13 — Cont’d 


*************************★****★★*******************j 

ReleaseCapture(); 

/* -- Kill the given window handle. */ 

SetCursor(LoadCursor(NULL, IDCARROW)); 

^ *****************************************************J 

1 

/* Pick the window under the cursor. */ 

l 

if (IpfnTimer != NULL) 

GetCursorPos(&pt); 

return; /* A kill is already pending. */ 

hwndPick = WindowFromPoint(pt); 



if ((IpfnTimer = (TIMERPROC)MakeProcInstance( 

/* Get the topmost ancestor of the window */ 

(FARPROC)TimerProc, hi ns)) ** NULL) 

/* picked. */ 

return; 

for (;;) 


f 

PostMessage(hwnd, WM TIMER, 0, (LPARAM)lpfnTimer); 

HWND hwndParent; 

/* Note that we can’t free the proc instance */ 


/* handle here since this the target app hasn't */ 

if ((hwndParent « GetParent(hwndPick)) == 

/* received the message yet. So we free it in */ 

NULL) 

/* the callback. */ 

break; 

I 

hwndPick = hwndParent; 

void CALLBACK 

i 

TimerProc(HWND hwnd, UINT wm, UINT wParam, 


DWORD IParam) 

/* Let the user know which window has been */ 

j*****************************************************j 

/* picked. */ 

/* -- Timer callback. */ 

wsprintf(szBuf, "%x", (UINT)hwndPick); 

/* -- Destroy the window timer message was sent to. */ 

SetDlgltemText(hwnd, didWindow, szBuf); 

\ 

j ********** ********************************* **********j 

/ 

break; 

FreeProcInstance((FARPR0C)1pfnTimer); 

i 

IpfnTimer = NULL; 


DestroyWindow(hwnd); 

return TRUE; 

1 

I 

void 

/* End of File */ 

Ki1IWnd(HWND hwnd) 
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Q l am writing a screen saver. When the screen saver is 
active, it looks for mouse or keyboard input to deac¬ 
tivate itself. If a DOS shell is active, I need to prevent the 
screen saver from kicking in, since all input will be going to 
the DOS shell. Is there a way to see if the DOS shell is active 
from within Windows? 

Jack de Winter 
Research In Motion Limited 
180 Columbia St. W, Bldg. 1-1111 
Waterloo, Ontario, Canada N2L 3L3 

A I assume from your question that you are only worried 
about enhanced mode. In standard mode, a Windows 
application will never get any queued messages when a DOS 
box is active. So there would be no way your screen saver 
could detect that it should go into save mode. 

As far as I can tell, there is no Windows API that will tell 
you if a DOS box (i.e., non-system virtual machine) is receiving 
hardware input (i.e., mouse and keyboard). These services are 


Listing 14 (killer.h) 


/*****************************************************j 

/* — Dialog constants. 

*/ 

/*****************************************************/ 

Idefine didWindow 0x2000 
#define didPick 0x2001 
#define didKill 0x2002 


/* End of File */ 
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Listing 15 (killer.rc) 

j************************************★***★*★★*******★★j 

/* — Resource file for killer app. */ 

j*****************************************************j 

linclude <windows.h> 
linclude “killer.h“ 

Killer 

DIALOG 70, 56, 84, 36 

STYLE DS_MODALFRAME | WS_MINIMIZEBOX | WS_P0PUP | 
WS_VISIBLE | WS_CAPTION | WS_SYSMENU 
CAPTION “App Killer" 

FONT 8, “Helv" 

BEGIN 

LTEXT “Window:", -1, 2, 2, 30, 10 

LTEXT ““, didWindow, 38, 2, 44, 10 

DEFPUSHBUTTON "&Pick", didPick, 2, 20, 38, 14 
PUSHBUTTON “&Kill", didKill, 42, 20, 38, 14 
END 


provided at the virtual device (VxD) level, and I think that in 
this case only a VxD can provide the functionality you require 
(it was high time I checked out VxD’s anyway!). 

All Windows applications run in the system VM. Each DOS 
box runs in its own VM. So the question can be rephrased as, 
“Which VM is receiving hardware input?” If the answer is the 
system VM, then it is safe for your screen saver to enter save 
mode. There are two services that can provide you with all 
the information you need: VKD_Get_Kbd_Owner and 
Get_Sys_VM_Handle. VKD_Get_Kbd_Owner is a service provided 
by the keyboard VxD that returns the handle of the VM that 
has the keyboard focus. Whenever a DOS box is active, either 
in a window or full screen, it will have the keyboard focus. So 
keyboard focus is a necessary and sufficient condition to test 
for. The next service, Get_Sys_VM_Handle, is provided by the 
virtual machine manager (VMM), and returns the system VM 
handle. All you have to do is compare the handles returned 
by these two services. If they are the same, then you can 
enter screen save mode. However, these services are only 
available at ring 0, which is only available to the VMM and 
VxD’s — which means that you must write a VxD to access 
these services. 

Luckily, a VxD can export an API to less privileged Windows 
programs (see Thomas Olsen’s article, “Making Windows and 
DOS Programs Talk," in the May 1992 issue, page 30). This 
means you can implement an API in a very small VxD that, 
say, returns zero if the system VM has the keyboard focus, 
non-zero otherwise. This is exactly what the VxD “WddjKeyf,” 
implemented in Listing 7, does. 

I was assigned the number 0x2953 for the VxD’s device ID 
by Microsoft. As Mr. Olsen noted, you should apply to 
Microsoft if you plan on distributing a VxD to a wide audience. 
WddjKeyf does not need to maintain any per VM state, thus 
does not require an initialization procedure; as a result its con¬ 
trol procedure is basically a no-op. The protected-mode API 
dispatcher compares the API ID in EAX with the “get version" 
request (must be ID 0) and the "test system focus" request (I 
chose ID 1). It returns with the carry flag set if the requested 
function is neither of these values, otherwise it jumps to the 
appropriate routine. 


Listing 16 (killer.def) 

;; — Linker definition file for the killer app. 

* • 

NAME 

Killer 


DESCRIPTION 

'Killer' 


EXETYPE 

WINDOWS 


STUB 

'WINSTUB.EXE' 


CODE 

PRELOAD MOVEABLE DISCARDABLE 


DATA 

PRELOAD MOVEABLE MULTIPLE 


HEAPSIZE 

1024 


STACKSIZE 

10240 


EXPORTS 



KillerDlg @1 


TimerProc @2 



Listing 17 (makefile) 

iiiiiiiiiiiiiiiiiiiii#iiiiiiniiiiiiiiiiiiiii#iiiiiiiii 
II — Project file for killer app. II 

####################################################### 
all: killer.exe 

killer.obj: killer.c 

cl -c -AM -G2w -Od -Zdpe -W3 -DSTRICT killer.c 

killer.exe: killer.obj killer.def killer.rc 

link /N0D/m killer,,, libw mlibcew, killer.def 
rc killer 


r* *»»• * * • 


- 
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The two API routines are extremely simple. WddjKeyfGet- 
Version() just returns 0x0100 (first version of this VxD), and 
WddjKeyf Test () compares the VM handles of the system and 
keyboard owner. VMMCall is used to call Get_Sys_VM_Handle 
since it is provided by the VMM, while VxDCall is used to call 
VKD_Get_Kbd_Owner as it is provided by the keyboard VxD. 
The return values, including flags, are set in the client register 
struct (CRS) which is used to communicate with the caller. The 
VMM copies this struct to and from the corresponding 
registers of the client VM on entry to and exit from the VxD. 
On entry, EBP is set to the base of this struct. Wddj Keyf Tes t () 
uses both AX and DX to return the VM handle (32 bits) of the 
keyboard owner if it is not the system VM. If the system VM 
is the keyboard owner, both AX and DX are cleared. 

Listing 8 is the linear linker definition file. Listing 9 is the 
header file that defines the constants used by a Windows 
program to interface to WddjKeyf. Listing 10 is the 
makefile. The tools and include files used by WddjKeyf will 
require that you have a copy of the Microsoft Device Driver 
Kit (DDK). The VxD is installed into Windows by adding the 
line device=WddjKeyf.386 in the [386enh] section of the 
system, ini file. 

The next part is to create the Windows code to interface 
to WddjKeyf. Listing 11 presents a sample routine, WDosOwns- 
Keyboard(), which will call the VxD and return 1 if a DOS VM 
has the keyboard focus, 0 if the system VM has the keyboard 
focus, or -1 if an error is encountered. The multiplex interrupt, 
0x2f, is used with WddjKeyfs device ID to obtain the far ad¬ 
dress of the API entry point routine. This routine is called with 
the appropriate register values to execute the desired API. I 
declared the function pointer as returning a DWORD since Wddj¬ 
Keyf () will return a 32-bit VM handle when called with cmd- 
TestFocus if the keyboard is not owned by the system VM. 
WDosOwnsKeyboard() will return -1 if it could not obtain the 
address of the API entry point routine, or if the routine 
returned a bad version number. The return value is cast to a 
word when asking for the version number, since DX will con¬ 
tain garbage. Listing 12 is the interface to this function, and 
merely consists of the WDosOwnsKeyboard()'s prototype. 


Q Several people have asked the question: "How do you 
kill a Windows application from another Windows ap¬ 
plication?" 

A One of the gaps in the Windows 3.x API is that there is 
very little process control. Specifically, there is no 
equivalent of the UNIX ki 11 () system call. 

You can try posting a WM_CL0SE to the application, but this 
will not guarantee that the application will be killed. This can 
best be explained by the following code fragment, which is 
used in most top-level window procedures: 

case WM_CL0SE: 

/* Ok to close? */ 
if (!F0kToClose()) 
break; 


case WM_DESTR0Y: 

/* Notification that window */ 

/* is being destroyed. */ 

PostQuitMessage(); 
break; 

It is up to the application to decide if it should die when it 
receives WM_CL0SE. This allows applications a chance to save a 
dirty document. However, actually destroying the application's 
main window is usually sufficient to kill the application. 

Given the main window handle of an application, it would 
seem that just calling DestroyWindow() should do the job. Un¬ 
fortunately this is not the case. DestroyWindow() checks to 
make sure that the caller owns the window to destroy. It 
performs this check by comparing the queue handle of the 
current task with the queue handle of the window to kill. If 
they are not the same, the window is not destroyed and 
DestroyWindow() returns a 0 to indicate failure. 

What is required is a way to get the application to be 
killed to call DestroyWindow() itself! It turns out that there is 
an amazingly simple way to do this. The WM_TIMER message 
contains the address of a callback function in the IParam 
parameter. When DispatchMessage() is called to process 
WM_TIMER, and IParam is non-null, the callback is invoked and 
the message is discarded. The magical thing is that the current 
process is the one executing the callback. So the callback can 
call DestroyWindow() , which will then succeed. 

Listings 13 through 17 present a tiny utility program that 
uses this trick to kill an application picked with the mouse. 
Listing 13 is the C source. Listing 14 is the header file for defin¬ 
ing the control IDs. Listing 15 is the resource file that contains 
the dialog template. Listing 16 is the linker module definition 
file and Listing 17 is the makefile. 

The program displays a dialog box with two buttons: push¬ 
ing "Pick" allows the user to click on the application to kill, 
pushing "Kill" kills the currently picked application. In addition, 
a static text above the buttons displays the title “Window" 
and another beside it displays the value (in hex) of the cur¬ 
rently selected window. 

The “killer" application creates a dialog box with a NULL 
parent as its main window. This saves the overhead of 
registering a window class. After the user pushes the “Pick" 
button, the mouse is captured, so that the killer can receive a 
button-down event when the mouse is clicked on another 
application's window. The shape of the cursor is changed to 
let the user know that killer is in “pick” mode. Once a window 
is picked, its ancestor list is walked to retrieve the topmost 
ancestor. This will presumably be its main window. An in¬ 
stance procedure of the timer callback is created and the 
WM_TIMER message is posted to the application to kill when 
the user pushes “Kill." Since PostMessage() is asynchronous, 
the procedure instance handle cannot be released after the 
call, since the application being killed will not have received 
the message. Instead FreeProcInstance() is called from 
within the timer procedure itself. 

Paul Bonneau 

bonneauOhyper.hyper.com 

from CompuServe: >INTERNET:bonneau@hyper.hyper.com □ 


Page 64 — Windows/DOS Developer’s Journal 


September 1992 


September 1992 


(continued from page 8) 

Celtic Software Provides DDE for DOS Applications 


Win-Link DDE Server is a new product that allows DOS ap¬ 
plications running under enhanced-mode Windows to com¬ 
municate with Windows applications via DDE. The Win-Link 
DDE Server consists of a Windows program that translates 
the DDE messages, and a library of functions developers can 
use to ease the task of sending DDE messages. The package 
includes source code for this library along with a demonstra¬ 


tion application that establishes a link with an Excel spread 
sheet. 

Win-Link DDE Server costs $49.99 and requires Celtic 
Software's Win-Link Developer’s Kit, which costs $249. For 
more information, contact Celtic Software, Inc., 4857 
Havana Drive, Pittsburgh, PA 15239, (800) 2-CELTIC; FAX 
(412) 798-0516. 


VMData Offers High-Level Virtual Memory Services 


Pocket Soft has released VMData, a new suite of memory 
management libraries that provide a uniform, cross-platform 
API for implementing virtual memory. VMData gives your pro¬ 
gram access to more data than will fit in available memory, 
providing transparent, prioritized access to conventional 
memory, EMS, XMS (including the HMA and UMBs), Windows 
memory (locked, discardable, and movable), OS/2 (real and 
protected mode), and disk. 

VMData uses page management, swapping memory in 
2Kb blocks to fulfill memory management requests. The 
page management is automatic - when you request a piece 
of data, VMData moves it into contiguous addressable 
memory, if necessary, and provides a pointer to it. When 
you finish using that memory, you release it and VMData is 


free to move it elsewhere, according to an LRU swapping al¬ 
gorithm. 

Besides simple virtual memory operations, VMData 
provides support for high-level data types and data opera¬ 
tions. It supports both variable and fixed-length records, vir¬ 
tual arrays, large buffers, and heap data. Operations 
supported include indexing, record sorting, hashing, sequen¬ 
tial data access, and others. The built-in support for these 
operations is designed to work optimally with the underly¬ 
ing virtual memory manager. 

VMData for DOS C costs $495 but has an introductory 
price of $295. You can purchase add-on support for OS/2 1.x 
or Windows 3.x for an additional $295. For more information, 
contact Pocket Soft, Inc., P.O. Box 821049, Houston, TX 
77282, (713) 460-5600; FAX (713) 460-2651. 


COM Card Takes Advantage of Windows 3.1 


Sealevel Systems, Inc. has released a serial interface card 
designed to take advantage of the expanded communica¬ 
tion port access Windows 3.1 offers. Windows 3.1, unlike 
Windows 3.0 and many motherboards and I/O boards, recog¬ 
nizes up to four communication ports. The COMM+232/EX al¬ 
lows you to add two RS232 serial ports to the standard 
COM1 and COM2. The interface features two independent RS- 
232 serial ports, selectable port addresses (COM1 through 
COMx), all RS-232 modem signals, and dual DB-9 male con¬ 
nectors. Interrupts are selectable or shareable (2-5 on an XT 

SDK Offers Targa Support 


connector and 10,11,12, and 15 on an AT connector) and a 
16550AFN buffered UART is available. 

The package includes a disk of utilities that control the 
board's ports and help you use the additional ports with ex¬ 
isting communications software. For example, you can use 
these utilities to make Windows 3.0 recognize COM3 and 
COM4. 

The Comm+232/EX (part #3085) costs $179. For more informa¬ 
tion, conatact Sealevel Systems, Inc, 102 West Main Street, 
Liberty, SC 29657, (803) 843-4343; FAX (803) 843-3067. 


Black Ice Software, Inc., has released the Targa SDK for 
Windows. This kit allows Windows developers to support 
Truevision, Inc's Targa graphics file format without having to 
learn the details of the Targa file format. The Targa file for¬ 
mat was designed to handle storage and manipulation of 
high-resolution color images, with a palette of up to 16.2 mil¬ 
lion colors. 

The routines in the Targa SDK allow you to load Targa 
Files into Windows Device Independent Bitmaps (DIBs) or 
save a bitmap in the Targa format with a single function call. 


Other routines let you rotate, invert, flip, and zoom Targa im¬ 
ages. The image functions support all modes of the Targa for¬ 
mat, including 8-bit, 24-bit, and 32-bit color models. 

The Targa SDK costs $149.95 and includes complete 
documentation. The SDK is a Windows DLL and is compatible 
with a variety of development environments, such as SQL 
Windows, Actor, C/C++, and Visual Basic. For more informa¬ 
tion, contact Black Ice Software, Inc., Crane Road, Somers, 
NY 10589, (914) 277-7006; FAX (914) 276-8418. 


RTLinkPlus V5.1 Supports MSC v7.0 and BCC v3.0 


Pocket Soft has released the latest version of their DOS 
linker, RTLinkPlus, which allows Microsoft C/C++ v7.o or Bor¬ 
land C++ v3.0 programmers to fully exploit advanced DOS 
memory-management capabilities. RTLinkPlus replaces the 
compiler vendor's linker to produce programs that execute 
faster, require less memory, and take advantage of 
whatever memory configuration exists at runtime. The 
product requires no special hardware or coding changes and 
provides full support for CodeView and Turbo Debugger. 

RTLinkPlus v5.1 can strip unreferenced code during link¬ 
ing. This is an important feature for C++, since modules that 
implement C++ classes tend to contain many smaller mem¬ 
ber functions, only some of which are actually referenced by 
any given application. For Microsoft C/C++ v7.0, RTLinkPlus 
also supports memory-swapping at the routine and function 
level, instead of at the object module level. 


RTLinkPlus offers a flavor of virtual memory called Virtual 
Memory Linking (VML) that allows programmers to design 
how memory is used and to optimize the way the program 
executes. VML also provides support for virtualizing both 
code and data, even data that changes during execution. 

VML places no restrictions on virtualizing C or C++ code and 
few restrictions on assembly code. This version also provides 
support for debugging large programs, including tracing 
memory-management runtime errors. Besides virtual 
memory, the product provides a multiple/nested overlay 
scheme that programmers can use independently or to com¬ 
plement the virtual memory. 

RTLinkPlus v5.1 lists for $495; an upgrade costs $135. For 
more information, contact Pocket Soft, Inc., P.O. Box 
821049, Houston, TX 77282, (713) 460-5600; FAX (713) 
460-2651. 
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Full-source Ethernet Snooper Supports Lan Manager and Netware 


General Software has released a software-based protocol 
analyzer for Ethernet networks called The Snooper. The pro¬ 
gram can run on any PC and capture live traffic on Ethernet 
networks, saving the captured packets for analysis through 
summary, hexadecimal, or decoded protocol displays. 

The Snooper is also a source-code toolkit that can help 
developers build custom protocol analyzers for additional 
protocols. The package includes free drivers (including 
source) for popular Ethernet host adapters, including Novell- 


compatible NE1000 and NE2000 boards, as well as boards 
from 3Com, IBM, and others 

The Snooper costs $350 and provides protocol support 
for Novell NetWare 286, NetWare 386, Microsoft LAN 
Manager, and IBM LAN Server. For more information, contact 
General Software, P.O. Box 2571, Redmond, WA 98073, 
(206) 391-4285; FAX (206) 746-46 55. 


Toolkit Adds Bitmap Features to Windows Applications 


Black Ice Software has released the Image Software 
Development Kit, a complete toolkit that gives Windows ap¬ 
plication developers control of screen bitmaps. The library 
functions fall into four different groups: import, export, 
screen manipulation, and conversion. 

Import functions handle files in bitmap (.bmp), Microsoft 
Paintbrush (.msp), Microsoft Metafile (.wmf), Windows clip¬ 
board (.dp), and ASCII file formats. Export functions accom¬ 
modate .bmp, .msp, .wmf, and .clp formats. Screen 
manipulation functions invert, rotate, flip, scale, and zoom 


screen images. Conversion functions transform text data to 
bitmaps, color bitmaps to monochrome, and metafiles to bit¬ 
maps. 

The Image SDK costs $199.95 and includes the library of 
bitmap functions, a programmer’s reference guide, and a 
sample Windows application that showcases all toolkit func¬ 
tions. For more information, contact Black Ice Software, 
Crane Road, Somers, NY 10589, (914) 277-7006; FAX (914) 
276-8418. 


VB/ISAM NT Provides Multi-User DBfor VB 


Software Source has released VB/ISAM NT, a multi-user 
network version of VB/ISAM, a record management exten¬ 
sion to Microsoft Visual Basic VB/ISAM NT is network-inde¬ 
pendent and provides both automatic data locking and 
semaphore functions you can use to coordinate multi-user 
data access. It is file- and program-compatible with the 
single-user version of VB/ISAM. 

The VB/ISAM API consists of eight main functions and 
eight utility functions. The package comes with a .BAS 
module containing the necessary function declarations to in¬ 
tegrate DLL into your Visual Basic program. Files can have up 
to 80 indexes. You can locate records by direct key lookup 


" WinSock" Specification Arrives 

The Windows Sockets Committee (made up of repre¬ 
sentatives from Microsoft, SunSelect, and other vendors) has 
produced the Windows Sockets API (colloquially known as 
“WinSock”), a public interface specification for TCP/IP applica¬ 
tions running under Windows. An application written to this 
interface will be able to run unchanged across TCP/IP im¬ 
plementations from a variety of vendors under Windows 
and Windows NT. 

WinSock is based on UNIX sockets and contains Win¬ 
dows-specific extensions for the message-driven Windows 
environment. The specification is intended for Windows 3.0, 


in any of the indexes, or by stepping forward or backward 
with index pointers. 

The proprietary file design handles variable-length 
strings (up to 32Kb); index fields can vary from zero to 250 
bytes in length. The library maintains search tables and 
memory caches that provide high-speed access to files as 
large as 512Mb. 

End-user runtime licenses for VB/ISAM NT cost $49 per 
user, in five-user increments; the single-user version of 
VB/ISAM costs $99.95 and is royalty-free. For more informa¬ 
tion, contact Software Source, 42808 Christy St, Ste. 222, 
Fremont, CA 94538, (510) 623-7854; FAX (510) 651-6039. 


Windows 3.1, and Windows NT. The WinSock specification is 
available in several forms. Internet users can FTP it from ar¬ 
chive sites, including vax.ftp.com and ftp.uu.net in the /ven- 
dor/microsoft directory. Microsoft will include the WinSock 
specification in the preliminary Win32 SDK for Windows NT 
and will place the specification on CompuServe (“go msl”). 

Spider Systems and Microsoft have jointly developed a 
Windows Sockets validation suite which they plan to make 
available to help vendors prove interoperability when 
developing Windows Sockets compliant transports. 


EMS Updates Turbo Pascal Library 

EMS Professional Shareware is shipping a new version of 
its TP Utility Library for programmers using Borland’s Turbo 
Pascal. This new version adds over 40 new public domain 
and shareware products from over 30 vendors to the library, 
which now contains 540 products. Files in the library are 
compressed with PKZIPand span 52 360Kb or 13 1.44Mb dis¬ 
kettes. 

The library contains a wide variety of routines for dif¬ 
ferent areas of programming, including array manipulation, 
bit manipulation, Btrieve access, communications, data com¬ 
pression, databases, date and time manipulation, graphics, 


hypertext, math, memory management, multitasking, net¬ 
working, Paradox, sound, statistics and finance, TSRs, and a 
variety of Turbo Pascal for Windows routines. 

The TP Utility Library costs $79.50 and has a 30-day 
guarantee. The package includes a database index and 
search program to locate any product in the library (and 
every known commercial Turbo Pascal product) by type or 
text search across product descriptions. For more informa¬ 
tion, contact EMS Professional Shareware Libraries, 4505 
Buckhurst Ct., Olney, MD 20832, (301) 924-3594; FAX (301) 
963-2708. 
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Readers' Forum 


You can now send letters to the 
editor via Internet at the following 
address: 

wdletter@rdpub.com or 
"...!uunet!rdpub!wdletter" 
from CompuServe: 

>INTERNET:wdletter@rdpub.com 


l Me ask that letters with code listings 
be submitted in an ASCII text file on an 
MS-DOS formatted disk or via email. 
Providing us an electronic copy of the 
code will prevent typographical errors 
that might result from optical scanning 
or re-keyboarding. 


Editor's note: Corrected code for Chris 
Newbold, "Displaying Bitmapped Im¬ 
ages inside Dialog Boxes," Listing 5 
(June 1991, p. 39): 

In the three lines which begin "CON¬ 
TROL,” change the identifiers 

SS_BLACKRECT 
SS_GRAYRECT 
SS WHITE RECT 


to 

SS_BLACKFRAME 
SS_GRAYFRAME 
SS WHITEFRAME 


respectively. 


#: 456 SO/CompuServe Mail 
12-JUI-92 14:43 PDT 
Sb: Suggestions for Mag 
Fm: George Defenbaugh 

Tomorrow I'll be calling in a sub¬ 
scription to the Windows/DOS 
Developer’s Journal. I’m an experienced 
C programmer, but am just learning the 
Windows API. Your staff was kind 
enough to send me a sample copy of 
the June issue. One thing I've found 
missing from all publications and books 
is some of the _really_ basic stuff about 


how Windows messages are generated, 
from where, where they are sent, etc. 
Diagrams would be helpful. I guess 
what I’m suggesting is possibly a 
“Beginner's column” or tutorial column 
that would help clarify some points of 
confusion. For instance, one person 
passed on to me that the recognition of 
x,y,width,heighth in CreateWindowO 
depend on the style and class used. 
Where the heck is that documented? 
Possibly such a column could clarify 
murk like this. 

Thanks for the suggestion; you are 
definitely not alone. I probably would 
not label such a column a "Beginners" 
column. I think that the question 
“Where the heck is that documented?" 
is one that we still hear from folks with 
several years of Windows experience 
(you can certainly hear it in my office 
when I’m writing code!). So darn 
much is unintentionally undocumented 
or poorly documented, that you can 
continue to run into problems like this 
for years. One thing I would love to 
see documented is the order of mes¬ 
sages, when they are sent, and by 
whom. Brent Rector told me that he’s 
gotten a lot of positive feedback for in¬ 
cluding a simple table in his book that 
shows what messages arrive in what 
order when you create a window. I 
would definitely like to see some ar¬ 
ticles like that. While we don't have a 
column devoted to this task, if you run 
into something along those lines that 
can be phrased as a question, I invite 
you to submit it to Paul Bonneau, our 
Windows Q&A columnist. He handles 
a range of topics from the simple to 
the truly obscure. Also, perhaps some 
readers will be inspired to put pen to 
paper and write some articles that 
document some of that conceptual in¬ 
formation that the SDK should have 
documented in the first place. Thanks 
for the feedback, and we’re glad to 
have you on board! -rib 


# : 474 SO/CompuServe Mail 
20-JUI-92 01:48 PDT 
Sb: WDDj 
Fm: Jim Masse 

I just had to tell you that I’m really 
enjoying WDDJ. The article by Matt 
Pietrek in the July issue was excellent! 

I have to admit that I really liked 
Matt’s article too. In the magazine, we 
often have to strip code down to its 
bare essentials, but in my own code, I 
make heavy use of assert(). After trying 
out Matt’s macro, I wish every version 
of assert() gave a symbolic stack 
trace. Ironically, Matt doesn't use as- 
sert() that much himself — he was just 
looking for an excuse to describe the 
format of .sym files! —rib 


Mr. Burk, 

In your July ’92 "Reader’s Forum” you 
mention the "Common User Access Ad¬ 
vanced Interface Design Guide,” and 
your attempt at obtaining it. Unfor¬ 
tunately, I was told by my IBM rep that 
this particular manual is obsolete and 
probably very difficult to obtain. She 
told me that particular manual was 
probably split up among several dif¬ 
ferent publications. Table 1 is a list of 
IBM publications dealing with SAA and 
CUA you can probably get from your 
local IBM New Business Center. Do not 
go to a support center unless you own 
or use an IBM mainframe or mini. If you 
do, experience tells me you will 
probably get the old run-around. 

I was also interested to see the algo¬ 
rithm sent in by Dr. Marcel Feenstra. A 
couple of weeks after my letter and 
code was printed, I came up with the 
same idea Dr. Feenstra did. I coded my 
idea in assembler and inserted it in the 
TP code with the ASM statement. How¬ 
ever, due to an involved and large-scale 
document imaging project I was given, 
the changes were never really imple¬ 
mented in the application. In all reality, 
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the efficiency of the PChar2Str function 
doesn't matter in my application. That 
particular routine only converts ap¬ 
proximately 75 nine-character Social 
Security numbers per day, all at one 
time. The time saved by the new code 
does not make spending a half a day 
performing the update on the user's PC 
worthwhile. 

As for the "bug" Dr. Feenstra found, 
that was a big OOPS! In my application, 
the first position of the string contains a 
space for domestic SSNs and a 'C' for 
Canadian SSNs. (The actual numbers are 
both nine positions long.) The PChar2Str 
routine sent to you was modeled after 
a routine that converts the numeric 
part of the SSN only, ignoring the first 
character in the ASCIIZ string. I did not 


Table 1 

IBM Order # 

Title 

ZZ05-0474 

SAA Common User Access And OSF/Motif User Interface Style 
Comparison. 

SC26-4582 

System Application Architecture Common User Access Advanced 
Interface Design Guide (obsolete). 

SC23-2250 

AlXwindows Style Guide. 

Q321-5329 

SAA: Designing SAA Applications And User Interfaces From the IBM 
Systems journal, Vol. 27, No. 3, pp. 325-347. 

G321-5326 

SAA: Application Enabling In SAA From the IBM Systems Journal, 
Vol. 27, NO. 3, pp. 301-305 

GG66-3207 

SAA Common User Access Tips And Techniques 

GG24-3456 

CUA 1989 Evaluation 

SC26-4583 

SAA CUA Basic Interface Design Guide (probably obsolete) 

GG24-3580 

Developing A CUA Workplace Application (probably obsolete) 



Developer's 

Marketplace 


Serial Port 

Communications Tool 

SERIAL is a DOS program which turns your PC into a 
sophisticated tool for monitoring and analyzing 
asynchronous serial interface links. SERIAL captures 
both data and control line changes with time resolved to 
under 1 millisecond. Uses standard COMM hardware. 

□ Passively monitors both sides of link 
O Easy to use window and menu controls 

□ Context sensitive help system 

□ Multiple start up configurations 

O ASCII, Hex, EBCDIC, Custom Fonts — EGA/VGA 

□ Built-in font editor for custom fonts 

□ Multiple display window options 

□ Triggers with audible alert 

□ Assisted baud rate determination 

□ Buffer string searches 

□ Support for FIFO buffers on 16550 UARTS 
O Time stamping of both data and control lines 

□ CRC calculations 

□ Extensive technical manual 

□ Single user and corporate wide licenses 

□ Technical support 

Only $239 for single user license with 5 ft. cable, 
or $189 without cable. 

Allison Technical Services 

8343 Carvel, Houston, TX 77036 

PH # (713) 777-0401; FAX/BBS (713) 777-4746 

□ Request 129 on Reader Service Card □ 


Basie > C?! 


Basic is better than C when you 
use the ProBas library! Over 900 
routines, most in assembly, let you 
write fast, tight code without 
"C-headaches"! Easy to use, 30 
day money-back guarantee. For 
your FREE 20 page booklet call: 

800-447-9120 ext. 146 

TeraTech 

W146, 3 Choke Cherry Rd., 

60, Rockville MD 20850 
330-6764 Fax: 963-0436 
963-7478 9600-N-8-1 
"A Supercharger for Basic" - BYTE 
New Visual Basic tools available! 

□ Request 101 on Reader Service Card □ 
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With WindList™ you can 

• Examine all current windows 

• Go to any current Windows® task 

• Examine parent-child relationships 

• Change window styles interactively 

• Kill out-of-control tasks safely 

• Set up according to your taste 

...and lots more! Easy to use! Only 
$39.95 (60 day money-back guarantee). 
Please specify disk size, 3V2" or 5V4" HD. 



Springtime Software 

81 Amherst Avenue 
Waltham, MA 02154-3167 




□ Request 116 on Reader Service Card □ 



Simplify Real Time Programs with 

INTERWORK™ 


Concurrent Programming Toolkit 


New ve rsion 3.1 now available 

Interwork is a “C" program library that lets you write 
your programs as a set of cooperating concurrent 
tasks. Very useful for real-time applications, simula¬ 
tion, and parallel programming. 

FEATURES 

• Unlimited number of tasks 

• Fast context switching 

• Optional time sliced scheduling 
NEW! • Enhanced inter-task communication 
NEW! • Improved interrupt and trap handling 
NEW! • Expanded user’s guide with examples 

Interwork is available for the following systems: 

IBM PC, XT, AT PC-DOS 2.0 or later $269 

IBM PC AT XENIX 286 $279 

Intel 386 UNIX V.3/386 $369 

DEC VAX, Sun 3,4 UNIX BSD/Sun OS $369 


For more information please contact: 


A 1 


Block Island Technologies 

Innovative Computer Software 


15455 NW Greenbrier Parkway, Suite 210 
Beaverton, Oregon 97006 
(503) 690-7181 FAX (503) 645-7732 


□ Request 289 on Reader Service Card □ 


INDUCTIVE REACTANCE 


Great Graphics 
for Scientists and 
Engineersl 
FORTRAN, C, 
QuickBASIC, and 
Pascal. 

Source code. 
No royalties. 

$350 


INGRAF supports video, printers, and plotters 



□ Request 286 on Reader Service Card □ 

September 1992 



































































































nssp TCP/IP 

programmers! 

GENISYS Comm Pack++ 

GCP++ is 100% C++ DLL, providing a 
meta-API for encapsulated 
TCP/UDP/Telnet access, bufffer, file, 
and packetized voice. 

► Eliminate socket library learning 
curve 

► Speed development & debugging 

► No Royalties 

► Write portable applications using 
GCP++ versions Tor most leading 
stack vendors 

VOICE OVER ETHERNET 

(kit available) 

GENISYS Comm, Inc. 

314 South Jay Street, Rome, NY 13440 
_ (315) 339-5502 _ 

□ Request 112 on Reader Service Card □ 


f Windows Developers:^ 

Put an End to Memory Problems! 


- (formerly OptiMem) 

SmartHeap™ Optimal memory manage- 
for Windows rnent DLL for Windows 3.x. 


□ Fixes selector consumption, overhead, granu¬ 
larity, fragmentation. Supports heaps > 64K. 

□ Dramatically improves performance. 

□ ANSI C malloc, C++ new, dozens more APIs. 

□ Detects memory bugs including double-freeing, 
memory overwrites, wild pointers, and more! 

□ Programmatic heap walking and error handling. 

□ Ideal for dynamic data structures, e.g. lists. 

Kg 3 Only$395. (800)441-7822 

No royalties. Free, unlimited technical support. 
Unconditional 60-Day Money-Back Guarantee! 

Call to order or to request technical white paper descriptionI 


MicroQuill Software Publishing, Inc. 

,4900 25th Ave., NE. #206 • Seattle, WA 98105, 
Fax (206) 525-8309 • (206) 525-8218 


□ Request 133 on Reader Service Card □ 


Beat the Clock. 


> Performance Analysis 

■ Execution Timing 

> Periodic Interrupts 

■ Precision Delays 
' Manual Interrupts 



S7/f77 T 


$295 


Independent hardware provides five 16-bit 
250-nanosecond timers. Includes add-in card, 
breakout switch, reference guide, application 
and l/F library with FULL SOURCE CODE. 

zsmr/™ $749 

Virtual timers library for STATE Support 
included for most 9513 counter/timer boards. 
FULL SOURCE CODE INCLUDED. 

S7Z>P/ n * $. 29 

Debugger breakout switch and interface card. 

CALL (206) 644-3094 TO ORDER 


ALPHA LOGIC 

TECHNOLOGIES INC. 

2121 I52KD AVE NJB„ REDMOND Wa 9*0$2 


7 ^ 1 —< 


□ Request 118 on Reader Service Card □ 


$79 DATA ACQUISITION FOR PCs 

■ 24 UNES OF PROGRAMMABLE DIGITAL INPUT/OUTPUT 

■ 3 CHANNEL 8 BIT A/D CONVERTER 

■ 12 BIT COUNTER 

■ PLUGS INTO PC BUS AND INCLUDES MANUAL AND 
FLOPPY 

$149 TRUE RMS DMM W/RS232 

■ MEASURES AC/DC VOLTS, CURRENT, OHMS, 
FREQUENCY 

■ OPTO-ISOLATED SERIAL PORT WITH CABLE FOR PC 

■ 20 AMP CURRENT RANGE, 3D40KHZ FREQUENCY 

■ INCLUDES CABLE AND DATALOGGING SOFTWARE 

$239 A/D CONVERTER W/RS232 

■ 18 BIT 5.5 DIGIT RESOLUTION (1 IN 200,000 COUNTS) 

■ ADDRESSABLE, CONNECT UP TO 32 ON 1 RS232 PORT 

■ VIRTUAL INSTRUMENT SOFTWARE 8 CABLE INCLUDED 


PRAIRIE DIGITAL INC. 

846 17TH SIR INDUST PARK 
PRARIE DU SAC, Wl. 5357S 


MAIL, FAX, OR PHONE 
VISA, MC, CHECK, MO, 
OR PO ACCEPTED 


TEL 606-643-850G INCLUDE $6 FOR S&H 

FAX 606-643-6754 


□ Request 110 on Reader Service Card □ 


BAR CODE 
SOURCE CODE 

$45.00 

Source code for printing UPC codes, 
postal bar codes, and most other 
popular formats. Comprehensive 
collection of programs and routines 
in C, C++, Paradox, Quick Basic, 
GW Basic, Visual Basic, & Dbase. 
No runtime royalties. 

Eastern Digital Resources 
PO Box 1451 - Clearwater, SC 29822-1451 
Tel. (803) 593-0870 Fax. (803) 593-4522 
VISA - MC - COD - PO'S WELCOME 


□ Request 119 on Reader Sen/ice Card □ 


32-bit Protected Mode 
386 C Graphics Library 

Intel 386/486 C Code Builder 
MetaWare, MicroWay, SVS, 
Watcom & Zortech with 
Phar Lap 3861 ASM 

Mixed Raster/Vector, 
Scalable, Rotatable Font, 
VGA, SVGA, 8514/A, VESA, 
Hercules Graphics Station 
through 1024x768x256 (8-bit), 
640x480x32k (16-bit), 
512x480x16.7m (32-bit), 
WYSIWYG HP-GL/PostScript 
$200 NO ROYALTIES 
FULL SOURCE CODE 
Gary R. Olhoeft 
P.O. Box 10870 Edgemont 
Golden, CO 80401-0620 
303-877-3697 CIS 76665,2021 

□ Request 294 on Reader Service Card □ 


o™ 

VB=mc 2 

The Art of Visual Basic Programming ™ 

This amazing new book by J. D. Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility, Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 


ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 

□ Request 104 on Reader Service Card □ 
September 1992 


C and C++ DOCUMENTATION 


! AUTOMATED DOCUMENTATION ! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, 
counts comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPECIAL: C-DOC ($199) All 5programs 
integrated as DOS program (<15,000 lines) 

• NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-ring binder/case. 
Processes 150,000 lines, deferred reports. 

• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 

ONT, Canada Voice/Fax (4161-858-4466 

L5N-4M1 Demos/BBS (4161-858-19l6 


see AD INDEX tor our larger ad 


□ Request 135 on Reader Service Card □ 


NETWORK 

CONTROL 

LIBRARIES 

NETBIOS ROUTINES allows ac¬ 
cess to low-level network func¬ 
tions. Name, session, and 
datagram routines. Wait and no¬ 
wait options. $99 

NETBIOS DLL for Windows $199 

NETWORK MASTER provides 
access to Netware internal func¬ 
tions. Complete network control 
from your compiled programs! $99 

Starlight Software 

P.O. Box 1090 

Wheeling, IL 60090 

(708) 394-0622 _ 

□ Request 170 on Reader Service Card □ 
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realize my slight mistake until Dr. 
Feenstra noted it in the letter. 

Sincerely, 

Kenneth Linder KA9RVK 

Thanks for the IBM manual list. 
Sometimes having the right order num¬ 
ber is the difference between success 
and frustration, —rib 


Dear Mr. Burk, 

I found Chris Newbold's article, "Dis¬ 
playing Bitmapped Images Inside Dialog 
Boxes" in the June 1992 issue very in¬ 
teresting. I have been using a similar 
feature in Borland’s custom control DLL. 
The Borland library also makes 
provision for displaying bitmaps of dif¬ 
ferent sizes depending upon whether 


the display is EGA or VGA. However, if 
the display resolution is higher than 
VGA, say 800x600 or 1024x768, the bit¬ 
map only occupies the upper left por¬ 
tion of the area it occupied on an EGA 
or VGA. I believe Mr. Newbold's code 
suffers from the same dependence on 
display resolution. 

One solution that I have found useful 
is to center the bitmap in the surround¬ 
ing frame or over an underlying control. 
The code is very much like that used 
by William Smith in his article about 
centering windows in the same issue. 
Intercept the WMJNITDIALOG message 
and move the bitmap. As display 
resolution increases, the bitmaps oc¬ 
cupy smaller areas in the dialogs, but 
their location is always consistent and 
attractive. 


Sincerely, 

David D. Clark 
68678 CR 13 
Nappanee, IN 46550 

Good points. Handling different dis¬ 
play resolutions is one of the more 
tedious problems of Windows 
programming. We have an author 
working an article that shows how to 
easily achieve that BWCC “chiseled 
steel" look in a way that works for all 
screen resolutions. That article should 
appear in a couple of months, —rib 
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Image Compression 
for Windows 

★ Compress/Decompress images in 
10 seconds or less. 

★ Full Source Code & DLL’s Available 

★ Convert & View Multiple Images 

★ Royalty Free Developers Kit Available 

★ PRICES START AT $99.00! 

Regular and Extended Dos also available 
® PHONE: 1-800-966-4487 
305-962-9961 
FAX: 305-962-6546 
Information Technologies Research,Inc 
3520 W Hallandale Beach Blvd 
Pembroke Park, FL 33023 
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Windows 3.1 
Text Printing Utility 

Causality for Windows 

“Prints source code in a flash” 

Fast! Easy! Flexible! 

Install, configure, and forget about 
it. It’s that easy! Drag files from File 
Manager and Drop on Causality for 
Windows. Causality formats and 
prints them to your specifications. 
Customize tab expansion, orientation, 
font face, font size, and margins for 
each file type you use. Causality 
automatically remembers your 
settings. 

Just $79. Call or write for a demo. 

Non-Causal Systems, Inc. 1-800-221-9423 
4691 N. University Dr., Suite 384 
Coral Springs, FL 33067 
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COM1: - COM4: 
WITH WINDOWS! 

• 1.2, OR 4 PORT RS-232 BOARDS 

• RS-232 ANO RS422 VERSIONS 

• WINDOWS UTILITY SOFTWARE 
PROVIDED 

• XT AND AT INTERRUPT JUMPERS 

• OTHER PRODUCTS INCLUDING 
LAPTOP ADD-ONS 

• DELhiRY FROM STOCK* ‘ 


cp/ti f\7FI sealevel systems inc. 

JLriLL V LL po box 830 

_ LIBERTY, SC 29657 

COMMUNICATIONS . VO ^ ^3 
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INTERNATIONAL 
SOFTWARE 
ASSIGNMENTS 

YOUR PASSPORT TO AN 
INTERNATIONAL CAREER 

The International Computer Professional Association 
provides you with the world-wide contacts you need to find an 
exciting software assignment overseas. 

Every two weeks you'll receive a detailed listing of 
current software assignments taxed directly to the ICPA by 
recruiters in London, Paris, and many other cities. Youll also 
receive valuable advice from software professionals with first¬ 
hand international experience. 

•Learn about exdtng contract and permanent positions overseas 
•Make up to $70,000 tax-free, even when working In Europe 
•Sel-up an international consultancy and work throughout die world 

As a member of ICPA you become part of a dynamic 
international network of software professionals. Peope with 
years of experience in the international market who will show 
you how to find an assignment overseas. 

To find out more about how to join the ICPA 

Call (415) 695 7618 
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ButtonTool/EditTool Combo 
for 

Visual Basic™ Users 

ButtonTool creates "VISUAL” 
buttons and more! EditTool 
creates formatted input fields. 
$89.95 + $7 S&H. No royalties 
Visa/M C/Am ex 


To order call: 
1-800-845-0386 
FAX: 713-523-0386 



OUTRIDER SYSTEMS, ISC. 
3701 Kirby Dr., Ste 1 1 96 
Houston ,TX 77098 Dept W 
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Windows 
Developer Jobs 


Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 

Mac, CASE, Video, Realtime. 

Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1-800-231-5920 
Scientific Placement, Inc. 



SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SPI-8, Box 71, San Ramon, CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 926-6188 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
^ompuserve: 71250,3001; Genie: D.SMALL6 ^ 
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7L/0™ is FASTEST! 



RCS'“ 4.2 PVCS'“ TUB™ 3.0 TUB™ 5.0 


Times are to update a 45K library on a PC/XT. PVCS and TUB 3.0 are 
from Sept 87 PC Tech Journal. MKS RCS 4.2 and TUB 5.0 are newer. 

TUB™ is BEST! 

"Do not be fooled by the fact that this is the 
least expensive of the five packages reviewed 
here - TUB has features and power to spare ” 
John Rex, Computer Language 
"TUB is a great system" J. Vallino, PC Tech J 

• Full-Featured Version Control for Software 
Professionals. Check-in/out locking. Branching. 
Keywords. Wildcard and list-of-file support. Can 
merge parallel changes and undo intermediate 
revisions. Network and WORM support. Main¬ 
frame compatible deltas for Pansophic, ADR, IBM, 
etc.. Integrates with Opus " MAKE & Slick " MAKE. 

MS-DOS $139, OS/2 $195 + shipping visa/MC 
5 station LAN license $419 (OS/2 $595), call for other sizes 

BURTON SYSTEMS SOFTWARE 

PO Box 4156, Cary, NC 27519 (919) 233-8128 
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Notice to our Subscribers 

Occasionally, Windows/DOS Developer’s 
Journal makes its mailing list available to 
vendors of products we think our readers 
will find interesting. Current subscribers 
receive free information in the mail from 
these vendors. If you prefer that your 
name not be used in these mailings, 
please let us know. Just copy or clip this 
form and send it with your name and ad¬ 
dress to: 
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□ DEVELOPER’S JOURNAL 

1601 W. 23rd. SL.Ste. 200 
Lawrence, KS 66046-2743 


September 1992 


NetBIOS MADE EASY! 

for Win dows 3.x and DOS 

□ Shared DLL resources 
supports multiple 
applications and instances. 

□ Full post processing support 
& notification via messages 
(wait, no-wait, and polled). 

□ Complete NCB and attached 
data buffer functions simplify 
memory management. 

□ Single source for Windows & 
DOS with WINDOWS.TXT. 

□ Windows setup program and 
complete documentation. 

□ No royalties, full source and 
demo programs $155.00! 

SIGMA SOFTWARE RESEARCH 
PO. Box 231239 
Montgomery , AL 36123-1239 
TEL (205) 244-7230 

Also available at the Programmers Shop! 
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The 

Sigma 

NetBIOS 

Engine 


Create High 
Performance 
Network 
Applications 
FAST! 

60 Day 
Money Back 
Guarantee! 




Visual Basic, 
BASIC, and PDS 
programmers! 

General Purpose Toolboxes 
-©trpfiics 
„#Wlen Design 
rfsfflfflmunicofions 


*st(S8f Printing 
Sifentific Applications 
#4^' nnd more! 



Crescent Software offers mony tools for 
QuickBASIC, PDS, and Visual Basic. All 
products include complete source code, 
free technical support, ond royalties ore 
never required! TOuitwistinHixMowcwas 
CALL TOLL FREE 


CRESCENT SOFTWABE, INC. 

11 BAILEY AVENUE 
RIDGEFIELD. CT 06877-4505 
203 4385300 FAX 203431 4626 


Attn: Programmers! 


Do you work with prototypes, 

interface design, documentation 

writing, or training? 

For $69.95 SnapPRO! will save 

you time with all of the above. 

• Hotkey capture of Windows&DOS screens 

• Easily convert graphic files. Supports 10 
formats ... Windows, Mac, Dos, & OS/2 

• Resize , overlay, mask & COMBINE 
bitmaps, vectors & clipart into your own 
unique image 

"SnapPRO! Is the easiest to use screen 
capture and conversion product for 
Window that I've see." 

Ted Vegvari, Security Padfic(PCWEEK Lab Partner) 

To order call Window Painters nt (612) 897-1305 
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Wilsoft carries a complete line of bar 
code software and hardware for your 
every need. All major bar code types 
supported. Call the most experienced 
company in the bar code field today. 
DOS and Xenix/Unix support. Por¬ 
table readers too! 

VISA/MC/AM EX/DISCOVER 
PO Box 6186 

Ft. Lauderdale, FL 33310-6186 
(305) 779-2720 
(305) 763-3096 Fax 
(800) 779-2720 Sales 
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Simtel MSDOS CDROM $24.95 

550 meg, 8300 programs. Programming tools, 
dos utilities, tech docs, comm, bbs, publishing, 
ham-radio, education, much more. Made June 92. 

CICA MS Windows CD $24.95 

Hundreds of MS Windows programs. Utilities, 
games, source code, programming tools. July 92. 

Source Code CDROM $39.95 

Desktop Lib CDROM $39.95 

GIFs Galore CDROM $24.95 

OS/2 Archive CDROM $24.95 

CDROM Caddies $4.95 

Walnut Creek CDROM 

1547 Palos Verdes Mall 
Suite 260 

Walnut Creek, CA 94596 

+1 800 786-9907 

+1 510 947-5996 

+ 1 510 947-1644 FAX r Visa/MC/COD 
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InterActive CodeBase 4.5 


Date Expr 



Data 
cMalias 


d4alias_set 

d4append 

d4append blank 

d4append_start 

d4blank 

d4bof 

d4bottom 

d4check 

d4close 

d4close_all 

d4create 

d4delete 

d4deleted 

d4eof 

d4field_number 
d4flush_all 
d4flush recori 


d4free_b locks 
d4go 
d4go_eof 
d4lock 

d41ock_append 
d4Iock_file 
d4Jock_group 
d4Jock_index 
d4Iock_test 
d4Iock_test_append 
d4lock_test_file 
d4memo_compress 
d4num_fields 
d4open 
d4pack 
d4position 
4oositlon set 



d4recall 
d4reccount 
d4recno 
d4recordwidtt 
d4reindex 
d4seek 
d4seek_doublf 
d4skip 
d4tag_select 
d4top 

d4unlock_all 
d4unlock_appe 
d4unlock_file 
d4unlock_inde: 
d4unlock_reco 
ddupdate heai 
d 4 write 
d4zap 



• Multi-user 

• DOS, Unix, OS/2 Support 

• C++ Interface Included 


Complete DBMS for C, C++ and VB 
programmers - compatible with the data, 
index and memo files of dBASE III/IV, 
FoxPro 2 and Clipper. Try the super-fast, 
super-small FoxPro 2.0 CDX index files! 


• Windows 3 Data Entry 

• Clipper -> C Translator Available 




(Using Visual Basic? Try CodeBasic!) 




The C Library for DataBase Management 


SEQUITER I 

SOFTWARE INC. I 


TEL. 403*437*241 0 

FAX 403*436*2999 

Europe 33.20.24.20.14 


#209,9644-54 AVE., EDMONTON, AB, CANADA T6E-5V1 
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New BOUNDS-CHECKER 2.0 



Welcome to the age of 
automated memory/heap protection! 

NEW BOUNDS-CHECKER 2.0 is the cnly complete solution to MS-DOS 
memory end heap corruption problems, 

BOUND-CHECKER 2,0 is a single, easy to use utility that automatically 
detects problems in your programs heap, stack or data segment and 
finds illegal memory accesses outside of your program or in your code. 
In one step, you can quickly and easily flush out some of the most 
insidious bugs that you regularly encounter as a DOS programmer. 


• New 2.0 Features • 

Now works with 3rd party memory managers 

Heap, stack and data segment checking 

Smart Mode decides the legitimacy of an access automatically 

No need to see assembly code - call stack lets you view source 

of calling routines. 

New Auto Log mode (BC doesn't pop up) 

Supports C7.0 & Borland 3.1 & VROOM 

Order NOW! Only $199 


Using BOUNDS-CHECKER 2.0 is simple, there are no changes to be made 
to your source in any way, and no linking of code or macros into your 
executable. When a bug is found, BOUNDS-CHECKER pops up showing 
you precisely where the problem is. 

One of its innovative NEW features is Smart Mode. Smart Mode uses a 
built-in knowledge base to automatically determine if an out-of-bounds 
access is legitimate. This eliminates any complex decisions on your part, 
resulting in more power and flexibility than you may have thought 
possible. 

Don't take unnecessary risks with your program or your customers. 
BOUNDS-CHECK before you ship with NEW version 2.0. 


For even more debugging power, BOUNDS-CHECKER 2.0 
integrates with our award-winning Soft-ICE debugger which fea¬ 
tures powerful 386/486 based breakpoints. Equipped with this 
formidable combination, your de-bugging arsenal is prepared for 
any surprise attack of the DOS Nasties. 

Soft-ICE...$386 

BOUNDS-CHECKER 2.0 & Soft-ICE Bundle Only...$499 

BOUNDS-CHECKER AND SOFT-ICE ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES. INC. 


We're making C a Safe Language! 


call (603) 889-2386 
fax (603) 889-1135 

■fp] 

N 

u-Mesa 

RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 

^TECHNOLOGIES INC 

24 HOUR BBS 
603-595-0386 
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